@nativescript/canvas-three 2.0.0-webgpu.27 → 2.0.0-webgpu.28

package/three/src/lights/Light.d.ts

@@ -1,20 +1,20 @@
-import { JSONMeta, Object3D, Object3DJSON } from "../core/Object3D.js";
-import { Color, ColorRepresentation } from "../math/Color.js";
-import { LightShadow, LightShadowJSON } from "./LightShadow.js";
+import { JSONMeta, Object3D, Object3DJSON } from '../core/Object3D.js';
+import { Color, ColorRepresentation } from '../math/Color.js';
+import { LightShadow, LightShadowJSON } from './LightShadow.js';
 
 export interface LightJSON extends Object3DJSON {
-    color: number;
-    intensity: number;
+	color: number;
+	intensity: number;
 
-    groundColor?: number;
+	groundColor?: number;
 
-    distance?: number;
-    angle?: number;
-    decay?: number;
-    penumbra?: number;
+	distance?: number;
+	angle?: number;
+	decay?: number;
+	penumbra?: number;
 
-    shadow?: LightShadowJSON;
-    target?: string;
+	shadow?: LightShadowJSON;
+	target?: string;
 }
 
 /**
@@ -22,61 +22,61 @@ export interface LightJSON extends Object3DJSON {
  * @remarks All other light types inherit the properties and methods described here.
  */
 export abstract class Light<TShadowSupport extends LightShadow | undefined = LightShadow | undefined> extends Object3D {
-    /**
-     * Creates a new {@link Light}
-     * @remarks
-     * **Note** that this is not intended to be called directly (use one of derived classes instead).
-     * @param color Hexadecimal color of the light. Default `0xffffff` _(white)_.
-     * @param intensity Numeric value of the light's strength/intensity. Expects a `Float`. Default `1`.
-     */
-    constructor(color?: ColorRepresentation, intensity?: number);
+	/**
+	 * Creates a new {@link Light}
+	 * @remarks
+	 * **Note** that this is not intended to be called directly (use one of derived classes instead).
+	 * @param color Hexadecimal color of the light. Default `0xffffff` _(white)_.
+	 * @param intensity Numeric value of the light's strength/intensity. Expects a `Float`. Default `1`.
+	 */
+	constructor(color?: ColorRepresentation, intensity?: number);
 
-    /**
-     * Read-only flag to check if a given object is of type {@link HemisphereLight}.
-     * @remarks This is a _constant_ value
-     * @defaultValue `true`
-     */
-    readonly isLight: true;
+	/**
+	 * Read-only flag to check if a given object is of type {@link HemisphereLight}.
+	 * @remarks This is a _constant_ value
+	 * @defaultValue `true`
+	 */
+	readonly isLight: true;
 
-    /**
-     * A Read-only _string_ to check if `this` object type.
-     * @remarks Sub-classes will update this value.
-     * @defaultValue `Light`
-     */
-    override readonly type: string | "Light";
+	/**
+	 * A Read-only _string_ to check if `this` object type.
+	 * @remarks Sub-classes will update this value.
+	 * @defaultValue `Light`
+	 */
+	override readonly type: string | 'Light';
 
-    /**
-     * Color of the light. \
-     * @defaultValue `new THREE.Color(0xffffff)` _(white)_.
-     */
-    color: Color;
+	/**
+	 * Color of the light. \
+	 * @defaultValue `new THREE.Color(0xffffff)` _(white)_.
+	 */
+	color: Color;
 
-    /**
-     * The light's intensity, or strength.
-     * The units of intensity depend on the type of light.
-     * @defaultValue `1`
-     */
-    intensity: number;
+	/**
+	 * The light's intensity, or strength.
+	 * The units of intensity depend on the type of light.
+	 * @defaultValue `1`
+	 */
+	intensity: number;
 
-    /**
-     * A {@link THREE.LightShadow | LightShadow} used to calculate shadows for this light.
-     * @remarks Available only on Light's that support shadows.
-     */
-    shadow: TShadowSupport;
+	/**
+	 * A {@link THREE.LightShadow | LightShadow} used to calculate shadows for this light.
+	 * @remarks Available only on Light's that support shadows.
+	 */
+	shadow: TShadowSupport;
 
-    /**
-     * Copies value of all the properties from the {@link Light | source} to this instance.
-     * @param source
-     * @param recursive
-     */
-    copy(source: this, recursive?: boolean): this;
+	/**
+	 * Copies value of all the properties from the {@link Light | source} to this instance.
+	 * @param source
+	 * @param recursive
+	 */
+	copy(source: this, recursive?: boolean): this;
 
-    /**
-     * Frees the GPU-related resources allocated by this instance
-     * @remarks
-     * Call this method whenever this instance is no longer used in your app.
-     */
-    dispose(): void;
+	/**
+	 * Frees the GPU-related resources allocated by this instance
+	 * @remarks
+	 * Call this method whenever this instance is no longer used in your app.
+	 */
+	dispose(): void;
 
-    toJSON(meta?: JSONMeta): LightJSON;
+	toJSON(meta?: JSONMeta): LightJSON;
 }

package/three/src/lights/LightProbe.d.ts

@@ -1,5 +1,5 @@
-import { SphericalHarmonics3 } from "../math/SphericalHarmonics3.js";
-import { Light } from "./Light.js";
+import { SphericalHarmonics3 } from '../math/SphericalHarmonics3.js';
+import { Light } from './Light.js';
 
 /**
  * Light probes are an alternative way of adding light to a 3D scene.
@@ -22,26 +22,26 @@ import { Light } from "./Light.js";
  * @see {@link https://github.com/mrdoob/three.js/blob/master/src/lights/LightProbe.js | Source}
  */
 export class LightProbe extends Light {
-    /**
-     * Creates a new LightProbe.
-     * @param sh An instance of {@link THREE.SphericalHarmonics3 | SphericalHarmonics3}. Default `new THREE.SphericalHarmonics3()``.
-     * @param intensity Numeric value of the light probe's intensity. Expects a `Float`. Default `1`.
-     */
-    constructor(sh?: SphericalHarmonics3, intensity?: number);
+	/**
+	 * Creates a new LightProbe.
+	 * @param sh An instance of {@link THREE.SphericalHarmonics3 | SphericalHarmonics3}. Default `new THREE.SphericalHarmonics3()``.
+	 * @param intensity Numeric value of the light probe's intensity. Expects a `Float`. Default `1`.
+	 */
+	constructor(sh?: SphericalHarmonics3, intensity?: number);
 
-    /**
-     * Read-only flag to check if a given object is of type {@link DirectionalLight}.
-     * @remarks This is a _constant_ value
-     * @defaultValue `true`
-     */
-    readonly isLightProbe: true;
+	/**
+	 * Read-only flag to check if a given object is of type {@link DirectionalLight}.
+	 * @remarks This is a _constant_ value
+	 * @defaultValue `true`
+	 */
+	readonly isLightProbe: true;
 
-    /**
-     * A light probe uses spherical harmonics to encode lighting information.
-     * @defaultValue `new THREE.SphericalHarmonics3()`
-     */
-    sh: SphericalHarmonics3;
+	/**
+	 * A light probe uses spherical harmonics to encode lighting information.
+	 * @defaultValue `new THREE.SphericalHarmonics3()`
+	 */
+	sh: SphericalHarmonics3;
 
-    /** @internal */
-    fromJSON(json: {}): LightProbe;
+	/** @internal */
+	fromJSON(json: {}): LightProbe;
 }

package/three/src/lights/LightShadow.d.ts

@@ -1,20 +1,20 @@
-import { Camera } from "../cameras/Camera.js";
-import { Object3DJSONObject } from "../core/Object3D.js";
-import { Frustum } from "../math/Frustum.js";
-import { Matrix4 } from "../math/Matrix4.js";
-import { Vector2, Vector2Tuple } from "../math/Vector2.js";
-import { Vector4 } from "../math/Vector4.js";
-import { WebGLRenderTarget } from "../renderers/WebGLRenderTarget.js";
-import { Light } from "./Light.js";
+import { Camera } from '../cameras/Camera.js';
+import { Object3DJSONObject } from '../core/Object3D.js';
+import { Frustum } from '../math/Frustum.js';
+import { Matrix4 } from '../math/Matrix4.js';
+import { Vector2, Vector2Tuple } from '../math/Vector2.js';
+import { Vector4 } from '../math/Vector4.js';
+import { WebGLRenderTarget } from '../renderers/WebGLRenderTarget.js';
+import { Light } from './Light.js';
 
 export interface LightShadowJSON {
-    intensity?: number;
-    bias?: number;
-    normalBias?: number;
-    radius?: number;
-    mapSize?: Vector2Tuple;
+	intensity?: number;
+	bias?: number;
+	normalBias?: number;
+	radius?: number;
+	mapSize?: Vector2Tuple;
 
-    camera: Omit<Object3DJSONObject, "matrix">;
+	camera: Omit<Object3DJSONObject, 'matrix'>;
 }
 
 /**
@@ -23,147 +23,147 @@ export interface LightShadowJSON {
  * @see {@link https://github.com/mrdoob/three.js/blob/master/src/lights/LightShadow.js | Source}
  */
 export class LightShadow<TCamera extends Camera = Camera> {
-    /**
-     * Create a new instance of {@link LightShadow}
-     * @param camera The light's view of the world.
-     */
-    constructor(camera: TCamera);
-
-    /**
-     * The light's view of the world.
-     * @remark This is used to generate a depth map of the scene; objects behind other objects from the light's perspective will be in shadow.
-     */
-    camera: TCamera;
-
-    /**
-     * The intensity of the shadow. The default is `1`. Valid values are in the range `[0, 1]`.
-     */
-    intensity: number;
-
-    /**
-     * Shadow map bias, how much to add or subtract from the normalized depth when deciding whether a surface is in shadow.
-     * @remark The Very tiny adjustments here (in the order of 0.0001) may help reduce artifacts in shadows.
-     * @remarks Expects a `Float`
-     * @defaultValue `0`
-     */
-    bias: number;
-
-    /**
-     * Defines how much the position used to query the shadow map is offset along the object normal.
-     * @remark The Increasing this value can be used to reduce shadow acne especially in large scenes where light shines onto geometry at a shallow angle.
-     * @remark The cost is that shadows may appear distorted.
-     * @remarks Expects a `Float`
-     * @defaultValue `0`
-     */
-    normalBias: number;
-
-    /**
-     * Setting this to values greater than 1 will blur the edges of the shadow.toi
-     * @remark High values will cause unwanted banding effects in the shadows - a greater {@link LightShadow.mapSize | mapSize
-     *  will allow for a higher value to be used here before these effects become visible.
-     * @remark If {@link THREE.WebGLRenderer.shadowMap.type | WebGLRenderer.shadowMap.type} is set to {@link Renderer | PCFSoftShadowMap},
-     * radius has no effect and it is recommended to increase softness by decreasing {@link LightShadow.mapSize | mapSize} instead.
-     * @remark Note that this has no effect if the {@link THREE.WebGLRenderer.shadowMap | WebGLRenderer.shadowMap}.{@link THREE.WebGLShadowMap.type | type}
-     * is set to {@link THREE.BasicShadowMap | BasicShadowMap}.
-     * @remarks Expects a `Float`
-     * @defaultValue `1`
-     */
-    radius: number;
-
-    /**
-     * The amount of samples to use when blurring a VSM shadow map.
-     * @remarks Expects a `Integer`
-     * @defaultValue `8`
-     */
-    blurSamples: number;
-
-    /**
-     * A {@link THREE.Vector2 | Vector2} defining the width and height of the shadow map.
-     * @remarks Higher values give better quality shadows at the cost of computation time.
-     * @remarks Values must be powers of 2, up to the {@link THREE.WebGLRenderer.capabilities | WebGLRenderer.capabilities}.maxTextureSize for a given device,
-     * although the width and height don't have to be the same (so, for example, (512, 1024) is valid).
-     * @defaultValue `new THREE.Vector2(512, 512)`
-     */
-    mapSize: Vector2;
-
-    /**
-     * The depth map generated using the internal camera; a location beyond a pixel's depth is in shadow. Computed internally during rendering.
-     * @defaultValue null
-     */
-    map: WebGLRenderTarget | null;
-
-    /**
-     * The distribution map generated using the internal camera; an occlusion is calculated based on the distribution of depths. Computed internally during rendering.
-     * @defaultValue null
-     */
-    mapPass: WebGLRenderTarget | null;
-
-    /**
-     * Model to shadow camera space, to compute location and depth in shadow map.
-     * Stored in a {@link Matrix4 | Matrix4}.
-     * @remarks This is computed internally during rendering.
-     * @defaultValue new THREE.Matrix4()
-     */
-    matrix: Matrix4;
-
-    /**
-     * Enables automatic updates of the light's shadow. If you do not require dynamic lighting / shadows, you may set this to `false`.
-     * @defaultValue `true`
-     */
-    autoUpdate: boolean;
-
-    /**
-     * When set to `true`, shadow maps will be updated in the next `render` call.
-     * If you have set {@link autoUpdate} to `false`, you will need to set this property to `true` and then make a render call to update the light's shadow.
-     * @defaultValue `false`
-     */
-    needsUpdate: boolean;
-
-    /**
-     * Used internally by the renderer to get the number of viewports that need to be rendered for this shadow.
-     */
-    getViewportCount(): number;
-
-    /**
-     * Copies value of all the properties from the {@link {@link LightShadow} | source} to this Light.
-     * @param source
-     */
-    copy(source: LightShadow): this;
-
-    /**
-     * Creates a new {@link LightShadow} with the same properties as this one.
-     */
-    clone(recursive?: boolean): this;
-
-    /**
-     * Serialize this LightShadow.
-     */
-    toJSON(): LightShadowJSON;
-
-    /**
-     * Gets the shadow cameras frustum
-     * @remarks
-     * Used internally by the renderer to cull objects.
-     */
-    getFrustum(): Frustum;
-
-    /**
-     * Update the matrices for the camera and shadow, used internally by the renderer.
-     * @param light The light for which the shadow is being rendered.
-     */
-    updateMatrices(light: Light): void;
-
-    getViewport(viewportIndex: number): Vector4;
-
-    /**
-     * Used internally by the renderer to extend the shadow map to contain all viewports
-     */
-    getFrameExtents(): Vector2;
-
-    /**
-     * Frees the GPU-related resources allocated by this instance
-     * @remarks
-     * Call this method whenever this instance is no longer used in your app.
-     */
-    dispose(): void;
+	/**
+	 * Create a new instance of {@link LightShadow}
+	 * @param camera The light's view of the world.
+	 */
+	constructor(camera: TCamera);
+
+	/**
+	 * The light's view of the world.
+	 * @remark This is used to generate a depth map of the scene; objects behind other objects from the light's perspective will be in shadow.
+	 */
+	camera: TCamera;
+
+	/**
+	 * The intensity of the shadow. The default is `1`. Valid values are in the range `[0, 1]`.
+	 */
+	intensity: number;
+
+	/**
+	 * Shadow map bias, how much to add or subtract from the normalized depth when deciding whether a surface is in shadow.
+	 * @remark The Very tiny adjustments here (in the order of 0.0001) may help reduce artifacts in shadows.
+	 * @remarks Expects a `Float`
+	 * @defaultValue `0`
+	 */
+	bias: number;
+
+	/**
+	 * Defines how much the position used to query the shadow map is offset along the object normal.
+	 * @remark The Increasing this value can be used to reduce shadow acne especially in large scenes where light shines onto geometry at a shallow angle.
+	 * @remark The cost is that shadows may appear distorted.
+	 * @remarks Expects a `Float`
+	 * @defaultValue `0`
+	 */
+	normalBias: number;
+
+	/**
+	 * Setting this to values greater than 1 will blur the edges of the shadow.toi
+	 * @remark High values will cause unwanted banding effects in the shadows - a greater {@link LightShadow.mapSize | mapSize
+	 *  will allow for a higher value to be used here before these effects become visible.
+	 * @remark If {@link THREE.WebGLRenderer.shadowMap.type | WebGLRenderer.shadowMap.type} is set to {@link Renderer | PCFSoftShadowMap},
+	 * radius has no effect and it is recommended to increase softness by decreasing {@link LightShadow.mapSize | mapSize} instead.
+	 * @remark Note that this has no effect if the {@link THREE.WebGLRenderer.shadowMap | WebGLRenderer.shadowMap}.{@link THREE.WebGLShadowMap.type | type}
+	 * is set to {@link THREE.BasicShadowMap | BasicShadowMap}.
+	 * @remarks Expects a `Float`
+	 * @defaultValue `1`
+	 */
+	radius: number;
+
+	/**
+	 * The amount of samples to use when blurring a VSM shadow map.
+	 * @remarks Expects a `Integer`
+	 * @defaultValue `8`
+	 */
+	blurSamples: number;
+
+	/**
+	 * A {@link THREE.Vector2 | Vector2} defining the width and height of the shadow map.
+	 * @remarks Higher values give better quality shadows at the cost of computation time.
+	 * @remarks Values must be powers of 2, up to the {@link THREE.WebGLRenderer.capabilities | WebGLRenderer.capabilities}.maxTextureSize for a given device,
+	 * although the width and height don't have to be the same (so, for example, (512, 1024) is valid).
+	 * @defaultValue `new THREE.Vector2(512, 512)`
+	 */
+	mapSize: Vector2;
+
+	/**
+	 * The depth map generated using the internal camera; a location beyond a pixel's depth is in shadow. Computed internally during rendering.
+	 * @defaultValue null
+	 */
+	map: WebGLRenderTarget | null;
+
+	/**
+	 * The distribution map generated using the internal camera; an occlusion is calculated based on the distribution of depths. Computed internally during rendering.
+	 * @defaultValue null
+	 */
+	mapPass: WebGLRenderTarget | null;
+
+	/**
+	 * Model to shadow camera space, to compute location and depth in shadow map.
+	 * Stored in a {@link Matrix4 | Matrix4}.
+	 * @remarks This is computed internally during rendering.
+	 * @defaultValue new THREE.Matrix4()
+	 */
+	matrix: Matrix4;
+
+	/**
+	 * Enables automatic updates of the light's shadow. If you do not require dynamic lighting / shadows, you may set this to `false`.
+	 * @defaultValue `true`
+	 */
+	autoUpdate: boolean;
+
+	/**
+	 * When set to `true`, shadow maps will be updated in the next `render` call.
+	 * If you have set {@link autoUpdate} to `false`, you will need to set this property to `true` and then make a render call to update the light's shadow.
+	 * @defaultValue `false`
+	 */
+	needsUpdate: boolean;
+
+	/**
+	 * Used internally by the renderer to get the number of viewports that need to be rendered for this shadow.
+	 */
+	getViewportCount(): number;
+
+	/**
+	 * Copies value of all the properties from the {@link {@link LightShadow} | source} to this Light.
+	 * @param source
+	 */
+	copy(source: LightShadow): this;
+
+	/**
+	 * Creates a new {@link LightShadow} with the same properties as this one.
+	 */
+	clone(recursive?: boolean): this;
+
+	/**
+	 * Serialize this LightShadow.
+	 */
+	toJSON(): LightShadowJSON;
+
+	/**
+	 * Gets the shadow cameras frustum
+	 * @remarks
+	 * Used internally by the renderer to cull objects.
+	 */
+	getFrustum(): Frustum;
+
+	/**
+	 * Update the matrices for the camera and shadow, used internally by the renderer.
+	 * @param light The light for which the shadow is being rendered.
+	 */
+	updateMatrices(light: Light): void;
+
+	getViewport(viewportIndex: number): Vector4;
+
+	/**
+	 * Used internally by the renderer to extend the shadow map to contain all viewports
+	 */
+	getFrameExtents(): Vector2;
+
+	/**
+	 * Frees the GPU-related resources allocated by this instance
+	 * @remarks
+	 * Call this method whenever this instance is no longer used in your app.
+	 */
+	dispose(): void;
 }