super-three 0.181.0 → 0.185.0

package/src/renderers/webgpu/WebGPURenderer.js

@@ -32,6 +32,7 @@ class WebGPURenderer extends Renderer {
 	 *
 	 * @typedef {Object} WebGPURenderer~Options
 	 * @property {boolean} [logarithmicDepthBuffer=false] - Whether logarithmic depth buffer is enabled or not.
+	 * @property {boolean} [reversedDepthBuffer=false] - Whether reversed depth buffer is enabled or not.
 	 * @property {boolean} [alpha=true] - Whether the default framebuffer (which represents the final contents of the canvas) should be transparent or opaque.
 	 * @property {boolean} [depth=true] - Whether the default framebuffer should have a depth buffer or not.
 	 * @property {boolean} [stencil=false] - Whether the default framebuffer should have a stencil buffer or not.
@@ -40,7 +41,7 @@ class WebGPURenderer extends Renderer {
 	 * @property {boolean} [forceWebGL=false] - If set to `true`, the renderer uses a WebGL 2 backend no matter if WebGPU is supported or not.
 	 * @property {boolean} [multiview=false] - If set to `true`, the renderer will use multiview during WebXR rendering if supported.
 	 * @property {number} [outputType=undefined] - Texture type for output to canvas. By default, device's preferred format is used; other formats may incur overhead.
-	 * @property {number} [colorBufferType=HalfFloatType] - Defines the type of color buffers. The default `HalfFloatType` is recommend for best
+	 * @property {number} [outputBufferType=HalfFloatType] - Defines the type of output buffers. The default `HalfFloatType` is recommend for best
 	 * quality. To save memory and bandwidth, `UnsignedByteType` might be used. This will reduce rendering quality though.
 	 */
 

package/src/renderers/webgpu/descriptors/GPUBindGroupDescriptor.js

@@ -0,0 +1,48 @@
+/**
+ * Reusable descriptor for `GPUDevice.createBindGroup()`.
+ *
+ * @private
+ */
+class GPUBindGroupDescriptor {
+
+	constructor() {
+
+		/**
+		 * The label of the bind group.
+		 *
+		 * @type {string}
+		 */
+		this.label = '';
+
+		/**
+		 * The bind group layout the bind group conforms to.
+		 *
+		 * @type {?GPUBindGroupLayout}
+		 * @default null
+		 */
+		this.layout = null;
+
+		/**
+		 * The bind group entries.
+		 *
+		 * @type {Array<Object>}
+		 */
+		this.entries = [];
+
+	}
+
+	/**
+	 * Resets the descriptor to its default state. The internal `entries` array
+	 * is emptied without releasing its backing storage.
+	 */
+	reset() {
+
+		this.label = '';
+		this.layout = null;
+		this.entries.length = 0;
+
+	}
+
+}
+
+export default GPUBindGroupDescriptor;

package/src/renderers/webgpu/descriptors/GPUBufferDescriptor.js

@@ -0,0 +1,57 @@
+/**
+ * Reusable descriptor for `GPUDevice.createBuffer()`.
+ *
+ * @private
+ */
+class GPUBufferDescriptor {
+
+	constructor() {
+
+		/**
+		 * The label of the buffer.
+		 *
+		 * @type {string}
+		 */
+		this.label = '';
+
+		/**
+		 * The size of the buffer in bytes.
+		 *
+		 * @type {number}
+		 * @default 0
+		 */
+		this.size = 0;
+
+		/**
+		 * The allowed usages for the buffer.
+		 *
+		 * @type {number}
+		 * @default 0
+		 */
+		this.usage = 0;
+
+		/**
+		 * Whether the buffer is in the mapped state at creation.
+		 *
+		 * @type {boolean}
+		 * @default false
+		 */
+		this.mappedAtCreation = false;
+
+	}
+
+	/**
+	 * Resets the descriptor to its default state.
+	 */
+	reset() {
+
+		this.label = '';
+		this.size = 0;
+		this.usage = 0;
+		this.mappedAtCreation = false;
+
+	}
+
+}
+
+export default GPUBufferDescriptor;

package/src/renderers/webgpu/descriptors/GPUCommandEncoderDescriptor.js

@@ -0,0 +1,30 @@
+/**
+ * Reusable descriptor for `GPUDevice.createCommandEncoder()`.
+ *
+ * @private
+ */
+class GPUCommandEncoderDescriptor {
+
+	constructor() {
+
+		/**
+		 * The label of the command encoder.
+		 *
+		 * @type {string}
+		 */
+		this.label = '';
+
+	}
+
+	/**
+	 * Resets the descriptor to its default state.
+	 */
+	reset() {
+
+		this.label = '';
+
+	}
+
+}
+
+export default GPUCommandEncoderDescriptor;

package/src/renderers/webgpu/descriptors/GPUComputePassDescriptor.js

@@ -0,0 +1,38 @@
+/**
+ * Reusable descriptor for `GPUCommandEncoder.beginComputePass()`.
+ *
+ * @private
+ */
+class GPUComputePassDescriptor {
+
+	constructor() {
+
+		/**
+		 * The label of the compute pass.
+		 *
+		 * @type {string}
+		 */
+		this.label = '';
+
+		/**
+		 * Defines which timestamp values are written and where.
+		 *
+		 * @type {Object|undefined}
+		 */
+		this.timestampWrites = undefined;
+
+	}
+
+	/**
+	 * Resets the descriptor to its default state.
+	 */
+	reset() {
+
+		this.label = '';
+		this.timestampWrites = undefined;
+
+	}
+
+}
+
+export default GPUComputePassDescriptor;

package/src/renderers/webgpu/descriptors/GPUComputePipelineDescriptor.js

@@ -0,0 +1,48 @@
+/**
+ * Reusable descriptor for `GPUDevice.createComputePipeline()`.
+ *
+ * @private
+ */
+class GPUComputePipelineDescriptor {
+
+	constructor() {
+
+		/**
+		 * The label of the compute pipeline.
+		 *
+		 * @type {string}
+		 */
+		this.label = '';
+
+		/**
+		 * The pipeline layout the pipeline conforms to, or `'auto'`.
+		 *
+		 * @type {?GPUPipelineLayout|string}
+		 * @default null
+		 */
+		this.layout = null;
+
+		/**
+		 * The programmable compute stage.
+		 *
+		 * @type {?Object}
+		 * @default null
+		 */
+		this.compute = null;
+
+	}
+
+	/**
+	 * Resets the descriptor to its default state.
+	 */
+	reset() {
+
+		this.label = '';
+		this.layout = null;
+		this.compute = null;
+
+	}
+
+}
+
+export default GPUComputePipelineDescriptor;

package/src/renderers/webgpu/descriptors/GPUCopyExternalImageDestInfo.js

@@ -0,0 +1,47 @@
+import GPUTexelCopyTextureInfo from './GPUTexelCopyTextureInfo.js';
+
+/**
+ * Reusable descriptor for `GPUCopyExternalImageDestInfo`, the destination
+ * argument to `GPUQueue.copyExternalImageToTexture()`.
+ *
+ * @private
+ * @augments GPUTexelCopyTextureInfo
+ */
+class GPUCopyExternalImageDestInfo extends GPUTexelCopyTextureInfo {
+
+	constructor() {
+
+		super();
+
+		/**
+		 * The predefined color space the destination texture is interpreted in.
+		 *
+		 * @type {string}
+		 * @default 'srgb'
+		 */
+		this.colorSpace = 'srgb';
+
+		/**
+		 * Whether the destination texture has premultiplied alpha.
+		 *
+		 * @type {boolean}
+		 * @default false
+		 */
+		this.premultipliedAlpha = false;
+
+	}
+
+	/**
+	 * Resets the descriptor to its default state.
+	 */
+	reset() {
+
+		super.reset();
+		this.colorSpace = 'srgb';
+		this.premultipliedAlpha = false;
+
+	}
+
+}
+
+export default GPUCopyExternalImageDestInfo;

package/src/renderers/webgpu/descriptors/GPUCopyExternalImageSourceInfo.js

@@ -0,0 +1,50 @@
+/**
+ * Reusable descriptor for `GPUCopyExternalImageSourceInfo`, the source argument
+ * to `GPUQueue.copyExternalImageToTexture()`.
+ *
+ * @private
+ */
+class GPUCopyExternalImageSourceInfo {
+
+	constructor() {
+
+		/**
+		 * The image-like source.
+		 *
+		 * @type {?(ImageBitmap|ImageData|HTMLImageElement|HTMLVideoElement|VideoFrame|HTMLCanvasElement|OffscreenCanvas)}
+		 * @default null
+		 */
+		this.source = null;
+
+		/**
+		 * The origin offset within the source.
+		 *
+		 * @type {{x: number, y: number}}
+		 */
+		this.origin = { x: 0, y: 0 };
+
+		/**
+		 * Whether the source is flipped vertically before copying.
+		 *
+		 * @type {boolean}
+		 * @default false
+		 */
+		this.flipY = false;
+
+	}
+
+	/**
+	 * Resets the descriptor to its default state.
+	 */
+	reset() {
+
+		this.source = null;
+		this.origin.x = 0;
+		this.origin.y = 0;
+		this.flipY = false;
+
+	}
+
+}
+
+export default GPUCopyExternalImageSourceInfo;

package/src/renderers/webgpu/descriptors/GPUExtent3D.js

@@ -0,0 +1,51 @@
+/**
+ * Reusable descriptor for `GPUExtent3D` in its dictionary form, used by
+ * `GPUQueue.writeTexture()`, `GPUQueue.copyExternalImageToTexture()` and
+ * the various `GPUCommandEncoder` copy methods.
+ *
+ * @private
+ */
+class GPUExtent3D {
+
+	constructor() {
+
+		/**
+		 * The width of the extent.
+		 *
+		 * @type {number}
+		 * @default 0
+		 */
+		this.width = 0;
+
+		/**
+		 * The height of the extent.
+		 *
+		 * @type {number}
+		 * @default 1
+		 */
+		this.height = 1;
+
+		/**
+		 * The depth (for 3D textures) or number of array layers.
+		 *
+		 * @type {number}
+		 * @default 1
+		 */
+		this.depthOrArrayLayers = 1;
+
+	}
+
+	/**
+	 * Resets the descriptor to its default state.
+	 */
+	reset() {
+
+		this.width = 0;
+		this.height = 1;
+		this.depthOrArrayLayers = 1;
+
+	}
+
+}
+
+export default GPUExtent3D;

package/src/renderers/webgpu/descriptors/GPUPipelineLayoutDescriptor.js

@@ -0,0 +1,39 @@
+/**
+ * Reusable descriptor for `GPUDevice.createPipelineLayout()`.
+ *
+ * @private
+ */
+class GPUPipelineLayoutDescriptor {
+
+	constructor() {
+
+		/**
+		 * The label of the pipeline layout.
+		 *
+		 * @type {string}
+		 */
+		this.label = '';
+
+		/**
+		 * The set of bind group layouts the pipeline layout describes.
+		 *
+		 * @type {?Array<?GPUBindGroupLayout>}
+		 * @default null
+		 */
+		this.bindGroupLayouts = null;
+
+	}
+
+	/**
+	 * Resets the descriptor to its default state.
+	 */
+	reset() {
+
+		this.label = '';
+		this.bindGroupLayouts = null;
+
+	}
+
+}
+
+export default GPUPipelineLayoutDescriptor;

package/src/renderers/webgpu/descriptors/GPUQuerySetDescriptor.js

@@ -0,0 +1,47 @@
+/**
+ * Reusable descriptor for `GPUDevice.createQuerySet()`.
+ *
+ * @private
+ */
+class GPUQuerySetDescriptor {
+
+	constructor() {
+
+		/**
+		 * The label of the query set.
+		 *
+		 * @type {string}
+		 */
+		this.label = '';
+
+		/**
+		 * The type of queries managed by the set.
+		 *
+		 * @type {string|undefined}
+		 */
+		this.type = undefined;
+
+		/**
+		 * The number of queries managed by the set.
+		 *
+		 * @type {number}
+		 * @default 0
+		 */
+		this.count = 0;
+
+	}
+
+	/**
+	 * Resets the descriptor to its default state.
+	 */
+	reset() {
+
+		this.label = '';
+		this.type = undefined;
+		this.count = 0;
+
+	}
+
+}
+
+export default GPUQuerySetDescriptor;

package/src/renderers/webgpu/descriptors/GPURenderBundleEncoderDescriptor.js

@@ -0,0 +1,74 @@
+/**
+ * Reusable descriptor for `GPUDevice.createRenderBundleEncoder()`.
+ *
+ * @private
+ */
+class GPURenderBundleEncoderDescriptor {
+
+	constructor() {
+
+		/**
+		 * The label of the render bundle encoder.
+		 *
+		 * @type {string}
+		 */
+		this.label = '';
+
+		/**
+		 * The formats of the color attachments the bundle is compatible with.
+		 *
+		 * @type {?Array<?string>}
+		 * @default null
+		 */
+		this.colorFormats = null;
+
+		/**
+		 * The format of the depth/stencil attachment the bundle is compatible with.
+		 *
+		 * @type {string|undefined}
+		 */
+		this.depthStencilFormat = undefined;
+
+		/**
+		 * The number of samples per pixel the bundle is compatible with.
+		 *
+		 * @type {number}
+		 * @default 1
+		 */
+		this.sampleCount = 1;
+
+		/**
+		 * Whether the depth attachment is read-only.
+		 *
+		 * @type {boolean}
+		 * @default false
+		 */
+		this.depthReadOnly = false;
+
+		/**
+		 * Whether the stencil attachment is read-only.
+		 *
+		 * @type {boolean}
+		 * @default false
+		 */
+		this.stencilReadOnly = false;
+
+	}
+
+	/**
+	 * Resets the descriptor to its default state.
+	 */
+	reset() {
+
+		this.label = '';
+		this.colorFormats = null;
+		this.depthStencilFormat = undefined;
+		this.sampleCount = 1;
+		this.depthReadOnly = false;
+		this.stencilReadOnly = false;
+
+	}
+
+}
+
+export default GPURenderBundleEncoderDescriptor;

package/src/renderers/webgpu/descriptors/GPURenderPassColorAttachment.js

@@ -0,0 +1,72 @@
+/**
+ * Reusable descriptor for `GPURenderPassColorAttachment`, the type of each
+ * entry in `GPURenderPassDescriptor.colorAttachments`.
+ *
+ * @private
+ */
+class GPURenderPassColorAttachment {
+
+	constructor() {
+
+		/**
+		 * The texture view the pass renders into.
+		 *
+		 * @type {?GPUTextureView}
+		 * @default null
+		 */
+		this.view = null;
+
+		/**
+		 * The depth slice the pass renders into.
+		 *
+		 * @type {number|undefined}
+		 */
+		this.depthSlice = undefined;
+
+		/**
+		 * The texture view that receives the resolved output of multisampled rendering.
+		 *
+		 * @type {?GPUTextureView|undefined}
+		 */
+		this.resolveTarget = undefined;
+
+		/**
+		 * The clear value used when `loadOp` is `'clear'`.
+		 *
+		 * @type {Object|undefined}
+		 */
+		this.clearValue = undefined;
+
+		/**
+		 * The load operation performed at the start of the pass.
+		 *
+		 * @type {string|undefined}
+		 */
+		this.loadOp = undefined;
+
+		/**
+		 * The store operation performed at the end of the pass.
+		 *
+		 * @type {string|undefined}
+		 */
+		this.storeOp = undefined;
+
+	}
+
+	/**
+	 * Resets the descriptor to its default state.
+	 */
+	reset() {
+
+		this.view = null;
+		this.depthSlice = undefined;
+		this.resolveTarget = undefined;
+		this.clearValue = undefined;
+		this.loadOp = undefined;
+		this.storeOp = undefined;
+
+	}
+
+}
+
+export default GPURenderPassColorAttachment;