@vpmedia/phaser 1.123.0 → 1.124.0

package/src/phaser/display/webgl/shader/shader.test.ts

@@ -23,29 +23,29 @@ const createStubGl = (options: StubOptions = {}) => {
     createShader: vi.fn(() => ({})),
     shaderSource: vi.fn(),
     compileShader: vi.fn(),
-    getShaderParameter: vi.fn(() => true),
-    getShaderInfoLog: vi.fn(() => ''),
-    createProgram: vi.fn(() => program),
+    getShaderParameter: vi.fn((): boolean => true),
+    getShaderInfoLog: vi.fn((): string => ''),
+    createProgram: vi.fn((): object | null => program),
     attachShader: vi.fn(),
     linkProgram: vi.fn(),
-    getProgramParameter: vi.fn(() => linkStatus),
-    getProgramInfoLog: vi.fn(() => 'link failed'),
+    getProgramParameter: vi.fn((): boolean => linkStatus),
+    getProgramInfoLog: vi.fn((): string => 'link failed'),
     useProgram,
     deleteProgram,
-    getUniformLocation: vi.fn((_program: unknown, name: string) => {
+    getUniformLocation: vi.fn((_program: unknown, name: string): object | undefined => {
       if (!uniformLocations.has(name)) {
         uniformLocations.set(name, { name });
       }
       return uniformLocations.get(name);
     }),
-    getAttribLocation: vi.fn((_program: unknown, name: string) => attribLocations[name] ?? 0),
+    getAttribLocation: vi.fn((_program: unknown, name: string): number => attribLocations[name] ?? 0),
   } as unknown as WebGLRenderingContext;
   return { gl, deleteProgram, useProgram };
 };
 
-describe('WebGL shaders', () => {
-  describe('PrimitiveShader', () => {
-    it('resolves its uniforms and attributes on construction', () => {
+describe('WebGL shaders', (): void => {
+  describe('PrimitiveShader', (): void => {
+    it('resolves its uniforms and attributes on construction', (): void => {
       const { gl } = createStubGl({ attribLocations: { aVertexPosition: 0, aColor: 1 } });
       const shader = new PrimitiveShader(gl);
       expect(shader.program).not.toBeNull();
@@ -53,7 +53,7 @@ describe('WebGL shaders', () => {
       expect(shader.attributes).toStrictEqual([0, 1]);
     });
 
-    it('releases the program on destroy', () => {
+    it('releases the program on destroy', (): void => {
       const { gl, deleteProgram } = createStubGl();
       const shader = new PrimitiveShader(gl);
       shader.destroy();
@@ -62,24 +62,24 @@ describe('WebGL shaders', () => {
       expect(shader.gl).toBeNull();
     });
 
-    it('leaves the program null when compilation fails', () => {
+    it('leaves the program null when compilation fails', (): void => {
       const { gl, useProgram } = createStubGl({ program: null });
       const shader = new PrimitiveShader(gl);
       expect(shader.program).toBeNull();
       expect(useProgram).not.toHaveBeenCalled();
     });
 
-    it('destroys cleanly after a failed compile', () => {
+    it('destroys cleanly after a failed compile', (): void => {
       const { gl } = createStubGl({ program: null });
       const shader = new PrimitiveShader(gl);
-      expect(() => {
+      expect((): void => {
         shader.destroy();
       }).not.toThrow();
     });
   });
 
-  describe('StripShader', () => {
-    it('resolves its uniforms and attributes on construction', () => {
+  describe('StripShader', (): void => {
+    it('resolves its uniforms and attributes on construction', (): void => {
       const { gl } = createStubGl({
         attribLocations: { aVertexPosition: 0, aTextureCoord: 1, aColor: 2 },
       });
@@ -89,7 +89,7 @@ describe('WebGL shaders', () => {
       expect(shader.translationMatrix).toBeDefined();
     });
 
-    it('clears its attributes on destroy', () => {
+    it('clears its attributes on destroy', (): void => {
       const { gl } = createStubGl();
       const shader = new StripShader(gl);
       shader.destroy();
@@ -97,8 +97,8 @@ describe('WebGL shaders', () => {
     });
   });
 
-  describe('ComplexPrimitiveShader', () => {
-    it('resolves the uniforms it declares', () => {
+  describe('ComplexPrimitiveShader', (): void => {
+    it('resolves the uniforms it declares', (): void => {
       const { gl } = createStubGl();
       const shader = new ComplexPrimitiveShader(gl);
       expect(shader.tintColor).toBeDefined();
@@ -106,7 +106,7 @@ describe('WebGL shaders', () => {
       expect(shader.flipY).toBeDefined();
     });
 
-    it('leaves colorAttribute unresolved, as the shader never reads aColor', () => {
+    it('leaves colorAttribute unresolved, as the shader never reads aColor', (): void => {
       const { gl } = createStubGl();
       const shader = new ComplexPrimitiveShader(gl);
       expect(shader.colorAttribute).toBeUndefined();
@@ -114,8 +114,8 @@ describe('WebGL shaders', () => {
     });
   });
 
-  describe('FastShader', () => {
-    it('resolves the full attribute set in batch order', () => {
+  describe('FastShader', (): void => {
+    it('resolves the full attribute set in batch order', (): void => {
       const { gl } = createStubGl({
         attribLocations: {
           aVertexPosition: 0,
@@ -130,13 +130,13 @@ describe('WebGL shaders', () => {
       expect(shader.attributes).toStrictEqual([0, 1, 2, 3, 4, 5]);
     });
 
-    it('falls back to slot 2 when the driver reports aColor as -1', () => {
+    it('falls back to slot 2 when the driver reports aColor as -1', (): void => {
       const { gl } = createStubGl({ attribLocations: { aColor: -1 } });
       const shader = new FastShader(gl);
       expect(shader.colorAttribute).toBe(2);
     });
 
-    it('releases the program and buffers on destroy', () => {
+    it('releases the program and buffers on destroy', (): void => {
       const { gl, deleteProgram } = createStubGl();
       const shader = new FastShader(gl);
       shader.destroy();

package/src/phaser/display/webgl/shader_manager.test.ts

@@ -21,17 +21,17 @@ const createManager = (): { manager: WebGLShaderManager; gl: GlMocks } => {
 const shaderStub = (uid: string, attributes: number[]): NormalShader =>
   ({ _UID: uid, program: {}, attributes }) as unknown as NormalShader;
 
-describe('WebGLShaderManager', () => {
-  describe('constructor', () => {
-    it('starts with ten disabled attribute slots', () => {
+describe('WebGLShaderManager', (): void => {
+  describe('constructor', (): void => {
+    it('starts with ten disabled attribute slots', (): void => {
       const manager = new WebGLShaderManager();
       expect(manager.attribState).toHaveLength(10);
-      expect(manager.attribState.every((enabled) => enabled === false)).toBe(true);
+      expect(manager.attribState.every((enabled): boolean => enabled === false)).toBe(true);
     });
   });
 
-  describe('setAttribs', () => {
-    it('enables exactly the requested attribute slots', () => {
+  describe('setAttribs', (): void => {
+    it('enables exactly the requested attribute slots', (): void => {
       const { manager, gl } = createManager();
       manager.setAttribs([0, 2]);
       expect(gl.enableVertexAttribArray).toHaveBeenCalledTimes(2);
@@ -39,7 +39,7 @@ describe('WebGLShaderManager', () => {
       expect(gl.enableVertexAttribArray).toHaveBeenCalledWith(2);
     });
 
-    it('only touches slots whose state actually changed', () => {
+    it('only touches slots whose state actually changed', (): void => {
       const { manager, gl } = createManager();
       manager.setAttribs([0, 1]);
       vi.clearAllMocks();
@@ -48,7 +48,7 @@ describe('WebGLShaderManager', () => {
       expect(gl.disableVertexAttribArray).not.toHaveBeenCalled();
     });
 
-    it('disables slots dropped between calls', () => {
+    it('disables slots dropped between calls', (): void => {
       const { manager, gl } = createManager();
       manager.setAttribs([0, 1, 2]);
       vi.clearAllMocks();
@@ -58,13 +58,13 @@ describe('WebGLShaderManager', () => {
       expect(gl.enableVertexAttribArray).not.toHaveBeenCalled();
     });
 
-    it('mirrors the sparse temp state, leaving untouched slots unset', () => {
+    it('mirrors the sparse temp state, leaving untouched slots unset', (): void => {
       const { manager } = createManager();
       manager.setAttribs([1, 3]);
       expect(manager.attribState.slice(0, 4)).toStrictEqual([undefined, true, undefined, true]);
     });
 
-    it('disables the previously enabled slots when given no attributes', () => {
+    it('disables the previously enabled slots when given no attributes', (): void => {
       const { manager, gl } = createManager();
       manager.setAttribs([0, 1]);
       vi.clearAllMocks();
@@ -76,8 +76,8 @@ describe('WebGLShaderManager', () => {
     });
   });
 
-  describe('setShader', () => {
-    it('binds a new shader and reports that it switched', () => {
+  describe('setShader', (): void => {
+    it('binds a new shader and reports that it switched', (): void => {
       const { manager, gl } = createManager();
       const shader = shaderStub('a', [0, 1]);
       expect(manager.setShader(shader)).toBe(true);
@@ -85,7 +85,7 @@ describe('WebGLShaderManager', () => {
       expect(gl.useProgram).toHaveBeenCalledWith(shader.program);
     });
 
-    it('skips rebinding the shader already in use', () => {
+    it('skips rebinding the shader already in use', (): void => {
       const { manager, gl } = createManager();
       const shader = shaderStub('a', [0, 1]);
       manager.setShader(shader);
@@ -94,7 +94,7 @@ describe('WebGLShaderManager', () => {
       expect(gl.useProgram).not.toHaveBeenCalled();
     });
 
-    it('rebinds when a different shader is supplied', () => {
+    it('rebinds when a different shader is supplied', (): void => {
       const { manager } = createManager();
       manager.setShader(shaderStub('a', [0]));
       const next = shaderStub('b', [0, 1]);
@@ -103,8 +103,8 @@ describe('WebGLShaderManager', () => {
     });
   });
 
-  describe('destroy', () => {
-    it('clears attribute state and forgets the current shader', () => {
+  describe('destroy', (): void => {
+    it('clears attribute state and forgets the current shader', (): void => {
       const { manager } = createManager();
       manager.setShader(shaderStub('a', [0]));
       manager.destroy();
@@ -114,9 +114,9 @@ describe('WebGLShaderManager', () => {
       expect(manager._currentId).toBeNull();
     });
 
-    it('tolerates shaders that were never created', () => {
+    it('tolerates shaders that were never created', (): void => {
       const { manager } = createManager();
-      expect(() => {
+      expect((): void => {
         manager.destroy();
       }).not.toThrow();
     });

package/src/phaser/display/webgl/sprite_batch.ts

@@ -16,13 +16,13 @@ export class WebGLSpriteBatch {
   public lastIndexCount: number;
   public drawing: boolean;
   public currentBatchSize: number;
-  public currentBaseTexture: any;
+  public currentBaseTexture: BaseTexture | null;
   public dirty: boolean;
-  public textures: any[];
+  public textures: BaseTexture[];
   public blendModes: number[];
   public shaders: NormalShader[];
-  public sprites: any[];
-  public defaultShader: any;
+  public sprites: Image[];
+  public defaultShader: AbstractFilter;
   public gl!: IdentifiedWebGLRenderingContext;
   public vertexBuffer!: WebGLBuffer | null;
   public indexBuffer!: WebGLBuffer | null;
@@ -234,7 +234,7 @@ export class WebGLSpriteBatch {
       // bind the buffers
       gl.bindBuffer(gl.ARRAY_BUFFER, this.vertexBuffer);
       gl.bindBuffer(gl.ELEMENT_ARRAY_BUFFER, this.indexBuffer);
-      shader = this.defaultShader.shaders[gl.id];
+      shader = this.defaultShader.shaders[gl.id]!;
       // this is the same for each shader?
       const stride = this.vertSize * 4;
       gl.vertexAttribPointer(shader.aVertexPosition, 2, gl.FLOAT, false, stride, 0);
@@ -261,7 +261,7 @@ export class WebGLSpriteBatch {
     let shaderSwap = false;
     let sprite;
     for (let i = 0, j = this.currentBatchSize; i < j; i += 1) {
-      sprite = this.sprites[i];
+      sprite = this.sprites[i]!;
       nextTexture = sprite.tilingTexture ? sprite.tilingTexture.baseTexture : sprite.texture.baseTexture;
       nextBlendMode = sprite.blendMode;
       nextShader = sprite.shader ?? this.defaultShader;
@@ -317,8 +317,8 @@ export class WebGLSpriteBatch {
    * @param {number} size - The size of the batch.
    * @param {number} startIndex - The start index in the batch.
    */
-  public renderBatch(texture: BaseTexture, size: number, startIndex: number): void {
-    if (size === 0) {
+  public renderBatch(texture: BaseTexture | null, size: number, startIndex: number): void {
+    if (size === 0 || !texture) {
       return;
     }
     const { gl } = this;

package/src/phaser/display/webgl/stencil_manager.ts

@@ -5,9 +5,9 @@ import type { RenderSession } from '../render_session.js';
 
 export class WebGLStencilManager {
   public gl!: WebGLRenderingContext;
-  public stencilStack!: any;
-  public reverse!: any;
-  public count!: any;
+  public stencilStack!: GraphicsData[];
+  public reverse!: boolean;
+  public count!: number;
   /**
    * Initializes the stencil manager.
    */
@@ -29,7 +29,7 @@ export class WebGLStencilManager {
    * Sets up the stencil buffer for rendering.
    */
   public destroy(): void {
-    this.stencilStack = null;
+    this.stencilStack = [];
   }
 
   /**

package/src/phaser/display/webgl/texture_util.ts

@@ -7,7 +7,7 @@ import { Texture } from './texture.js';
  * @param {number} [scaleMode] - The scale mode to use for the texture.
  * @returns {BaseTexture} The newly created BaseTexture instance.
  */
-export const baseTextureFromCanvas = (canvas: HTMLCanvasElement, scaleMode: number): BaseTexture => {
+export const baseTextureFromCanvas = (canvas: HTMLCanvasElement, scaleMode?: number): BaseTexture => {
   if (canvas.width === 0) {
     canvas.width = 1;
   }
@@ -23,5 +23,5 @@ export const baseTextureFromCanvas = (canvas: HTMLCanvasElement, scaleMode: numb
  * @param {number} [scaleMode] - The scale mode to use for the texture.
  * @returns {Texture} The newly created Texture instance.
  */
-export const textureFromCanvas = (canvas: HTMLCanvasElement, scaleMode?: any): Texture =>
+export const textureFromCanvas = (canvas: HTMLCanvasElement, scaleMode?: number): Texture =>
   new Texture(baseTextureFromCanvas(canvas, scaleMode));

package/src/phaser/display/webgl/util.ts

@@ -73,7 +73,7 @@ export const initDefaultShaders = (): void => {};
 export const compileShader = (
   gl: WebGLRenderingContext,
   shaderSrc: string[] | string,
-  shaderType: any
+  shaderType: GLenum
 ): WebGLShader | null => {
   const src = Array.isArray(shaderSrc) ? shaderSrc.join('\n') : shaderSrc;
   const shader = gl.createShader(shaderType);

package/src/phaser/geom/circle.test.ts

@@ -2,16 +2,16 @@ import { expect, describe, it } from 'vitest';
 import { Circle } from './circle.js';
 import { Point } from './point.js';
 
-describe('Circle', () => {
-  describe('constructor', () => {
-    it('should initialize properties correctly when no arguments are provided', () => {
+describe('Circle', (): void => {
+  describe('constructor', (): void => {
+    it('should initialize properties correctly when no arguments are provided', (): void => {
       const circle = new Circle();
       expect(circle.x).toBe(0);
       expect(circle.y).toBe(0);
       expect(circle.diameter).toBe(0);
     });
 
-    it('should initialize properties correctly when x, y, and diameter are provided', () => {
+    it('should initialize properties correctly when x, y, and diameter are provided', (): void => {
       const circle = new Circle(10, 20, 30);
       expect(circle.x).toBe(10);
       expect(circle.y).toBe(20);
@@ -19,21 +19,21 @@ describe('Circle', () => {
     });
   });
 
-  describe('circumference', () => {
-    it('should calculate the circumference correctly when diameter is provided', () => {
+  describe('circumference', (): void => {
+    it('should calculate the circumference correctly when diameter is provided', (): void => {
       const circle = new Circle(0, 0, 1);
       expect(circle.circumference()).toBeCloseTo(Math.PI);
     });
 
-    it('should return Infinity when diameter is 0', () => {
+    it('should return Infinity when diameter is 0', (): void => {
       const circle = new Circle();
       circle.diameter = 0;
       expect(circle.circumference()).toBe(0);
     });
   });
 
-  describe('random', () => {
-    it('should generate a random point within the circle correctly', () => {
+  describe('random', (): void => {
+    it('should generate a random point within the circle correctly', (): void => {
       const circle = new Circle();
       const output = new Point();
       circle.random(output);
@@ -42,7 +42,7 @@ describe('Circle', () => {
       expect(Math.hypot(output.x, output.y)).toBe(0);
     });
 
-    it('should generate a random point within the circle correctly when output is not provided', () => {
+    it('should generate a random point within the circle correctly when output is not provided', (): void => {
       const circle = new Circle();
       const output = new Point();
       circle.random(output);
@@ -52,8 +52,8 @@ describe('Circle', () => {
     });
   });
 
-  describe('getBounds', () => {
-    it('should calculate the bounds correctly when diameter is provided', () => {
+  describe('getBounds', (): void => {
+    it('should calculate the bounds correctly when diameter is provided', (): void => {
       const circle = new Circle(0, 0, 1);
       const bounds = circle.getBounds();
       expect(bounds.x).toBe(-0.5);
@@ -62,7 +62,7 @@ describe('Circle', () => {
       expect(bounds.height).toBe(1);
     });
 
-    it('should return empty rectangle when diameter is 0', () => {
+    it('should return empty rectangle when diameter is 0', (): void => {
       const circle = new Circle();
       circle.diameter = 0;
       const bounds = circle.getBounds();
@@ -73,8 +73,8 @@ describe('Circle', () => {
     });
   });
 
-  describe('setTo', () => {
-    it('should set properties correctly when x, y, and diameter are provided', () => {
+  describe('setTo', (): void => {
+    it('should set properties correctly when x, y, and diameter are provided', (): void => {
       const circle = new Circle();
       circle.setTo(10, 20, 30);
       expect(circle.x).toBe(10);
@@ -82,15 +82,15 @@ describe('Circle', () => {
       expect(circle.diameter).toBe(30);
     });
 
-    it('should set radius property correctly when diameter is changed', () => {
+    it('should set radius property correctly when diameter is changed', (): void => {
       const circle = new Circle();
       circle.diameter = 1;
       expect(circle.radius).toBe(0.5);
     });
   });
 
-  describe('copyFrom', () => {
-    it('should copy properties correctly from another Circle instance', () => {
+  describe('copyFrom', (): void => {
+    it('should copy properties correctly from another Circle instance', (): void => {
       const source = new Circle(10, 20, 30);
       const dest = new Circle();
       dest.copyFrom(source);
@@ -100,8 +100,8 @@ describe('Circle', () => {
     });
   });
 
-  describe('copyTo', () => {
-    it('should copy properties correctly to another Circle instance', () => {
+  describe('copyTo', (): void => {
+    it('should copy properties correctly to another Circle instance', (): void => {
       const source = new Circle(10, 20, 30);
       const dest = new Circle();
       source.copyTo(dest);
@@ -111,22 +111,22 @@ describe('Circle', () => {
     });
   });
 
-  describe('distance', () => {
-    it('should calculate the distance correctly between two points within a circle', () => {
+  describe('distance', (): void => {
+    it('should calculate the distance correctly between two points within a circle', (): void => {
       const circle = new Circle();
       const point = new Point(1, 1);
       expect(circle.distance(point)).toBeCloseTo(Math.hypot(point.x, point.y));
     });
 
-    it('should return Infinity when diameter is 0', () => {
+    it('should return Infinity when diameter is 0', (): void => {
       const circle = new Circle();
       circle.diameter = 0;
       expect(circle.distance(new Point(1, 1))).toBeCloseTo(Math.SQRT2);
     });
   });
 
-  describe('clone', () => {
-    it('should create a deep copy of the Circle instance correctly', () => {
+  describe('clone', (): void => {
+    it('should create a deep copy of the Circle instance correctly', (): void => {
       const source = new Circle(10, 20, 30);
       const clone = source.clone();
       expect(clone.x).toBe(source.x);
@@ -135,35 +135,35 @@ describe('Circle', () => {
     });
   });
 
-  describe('contains', () => {
-    it('should determine if a point is within the circle correctly', () => {
+  describe('contains', (): void => {
+    it('should determine if a point is within the circle correctly', (): void => {
       const circle = new Circle();
       const point = new Point(1, 1);
       expect(circle.contains(point.x, point.y)).toBe(false);
     });
 
-    it('should return false when diameter is 0', () => {
+    it('should return false when diameter is 0', (): void => {
       const circle = new Circle();
       circle.diameter = 0;
       expect(circle.contains(1, 1)).toBe(false);
     });
   });
 
-  describe('circumferencePoint', () => {
-    it('should generate a point on the circumference correctly', () => {
+  describe('circumferencePoint', (): void => {
+    it('should generate a point on the circumference correctly', (): void => {
       const circle = new Circle();
       expect(circle.circumferencePoint(Math.PI / 2).x).toBeCloseTo(0.5 * circle.radius);
     });
 
-    it('should return null when diameter is 0', () => {
+    it('should return null when diameter is 0', (): void => {
       const circle = new Circle();
       circle.diameter = 0;
       expect(circle.circumferencePoint(Math.PI / 2).type).toBe(25);
     });
   });
 
-  describe('offset', () => {
-    it('should offset the circle correctly by a point', () => {
+  describe('offset', (): void => {
+    it('should offset the circle correctly by a point', (): void => {
       const circle = new Circle();
       const point = new Point(1, 1);
       circle.offset(point.x, point.y);
@@ -171,7 +171,7 @@ describe('Circle', () => {
       expect(circle.y).toBeGreaterThan(0);
     });
 
-    it('should return the Circle instance itself', () => {
+    it('should return the Circle instance itself', (): void => {
       const circle = new Circle();
       const point = new Point(1, 1);
       circle.offset(point.x, point.y);
@@ -179,8 +179,8 @@ describe('Circle', () => {
     });
   });
 
-  describe('offsetPoint', () => {
-    it('should offset the circle correctly by a point', () => {
+  describe('offsetPoint', (): void => {
+    it('should offset the circle correctly by a point', (): void => {
       const circle = new Circle();
       const point = new Point(1, 1);
       circle.offsetPoint(point);
@@ -189,8 +189,8 @@ describe('Circle', () => {
     });
   });
 
-  describe('toString', () => {
-    it('should generate the correct string representation of the Circle instance', () => {
+  describe('toString', (): void => {
+    it('should generate the correct string representation of the Circle instance', (): void => {
       const circle = new Circle();
       expect(circle.toString()).toBe('[{Circle (x=0 y=0 diameter=0 radius=0)}]');
     });

package/src/phaser/geom/circle.ts

@@ -182,7 +182,7 @@ export class Circle {
   /**
    * Sets the diameter of this circle.
    */
-  public set diameter(value) {
+  public set diameter(value: number) {
     if (value > 0) {
       this._diameter = value;
       this._radius = value * 0.5;
@@ -200,7 +200,7 @@ export class Circle {
   /**
    * Sets the radius of this circle.
    */
-  public set radius(value) {
+  public set radius(value: number) {
     if (value > 0) {
       this._radius = value;
       this._diameter = value * 2;
@@ -218,7 +218,7 @@ export class Circle {
   /**
    * Sets the left coordinate of this circle.
    */
-  public set left(value) {
+  public set left(value: number) {
     if (value > this.x) {
       this._radius = 0;
       this._diameter = 0;
@@ -238,7 +238,7 @@ export class Circle {
   /**
    * Sets the right coordinate of this circle.
    */
-  public set right(value) {
+  public set right(value: number) {
     if (value < this.x) {
       this._radius = 0;
       this._diameter = 0;
@@ -258,7 +258,7 @@ export class Circle {
   /**
    * Sets the top coordinate of this circle.
    */
-  public set top(value) {
+  public set top(value: number) {
     if (value > this.y) {
       this._radius = 0;
       this._diameter = 0;
@@ -278,7 +278,7 @@ export class Circle {
   /**
    * Sets the bottom coordinate of this circle.
    */
-  public set bottom(value) {
+  public set bottom(value: number) {
     if (value < this.y) {
       this._radius = 0;
       this._diameter = 0;
@@ -309,7 +309,7 @@ export class Circle {
   /**
    * Sets whether this circle is empty (zero diameter).
    */
-  public set empty(value) {
+  public set empty(value: boolean) {
     if (value) {
       this.setTo(0, 0, 0);
     }