@onerjs/core 8.23.12 → 8.25.0

package/Engines/engineCapabilities.d.ts

@@ -26,6 +26,8 @@ export interface EngineCapabilities {
     maxVertexUniformVectors: number;
     /** Maximum number of uniforms per fragment shader */
     maxFragmentUniformVectors: number;
+    /** The number of bits that can be accurately represented in shader floats */
+    shaderFloatPrecision: number;
     /** Defines if standard derivatives (dx/dy) are supported */
     standardDerivatives: boolean;
     /** Defines if s3tc texture compression is supported */
@@ -78,6 +80,8 @@ export interface EngineCapabilities {
     depthTextureExtension: boolean;
     /** Defines if float color buffer are supported */
     colorBufferFloat: boolean;
+    /** Defines if float color blending is supported */
+    blendFloat: boolean;
     /** Defines if half float color buffer are supported */
     colorBufferHalfFloat?: boolean;
     /** Gets disjoint timer query extension (null if not supported) */

package/Engines/engineCapabilities.js.map

@@ -1 +1 @@
-{"version":3,"file":"engineCapabilities.js","sourceRoot":"","sources":["../../../../dev/core/src/Engines/engineCapabilities.ts"],"names":[],"mappings":"","sourcesContent":["/**\r\n * Interface used to describe the capabilities of the engine relatively to the current browser\r\n */\r\n// eslint-disable-next-line @typescript-eslint/naming-convention\r\nexport interface EngineCapabilities {\r\n    /** Maximum textures units per fragment shader */\r\n    maxTexturesImageUnits: number;\r\n    /** Maximum texture units per vertex shader */\r\n    maxVertexTextureImageUnits: number;\r\n    /** Maximum textures units in the entire pipeline */\r\n    maxCombinedTexturesImageUnits: number;\r\n    /** Maximum texture size */\r\n    maxTextureSize: number;\r\n    /** Maximum texture samples */\r\n    maxSamples?: number;\r\n    /** Maximum draw buffers */\r\n    maxDrawBuffers?: number;\r\n    /** Maximum cube texture size */\r\n    maxCubemapTextureSize: number;\r\n    /** Maximum render texture size */\r\n    maxRenderTextureSize: number;\r\n    /** Maximum number of vertex attributes */\r\n    maxVertexAttribs: number;\r\n    /** Maximum number of varyings */\r\n    maxVaryingVectors: number;\r\n    /** Maximum number of uniforms per vertex shader */\r\n    maxVertexUniformVectors: number;\r\n    /** Maximum number of uniforms per fragment shader */\r\n    maxFragmentUniformVectors: number;\r\n    /** Defines if standard derivatives (dx/dy) are supported */\r\n    standardDerivatives: boolean;\r\n    /** Defines if s3tc texture compression is supported */\r\n    s3tc?: WEBGL_compressed_texture_s3tc;\r\n    /** Defines if s3tc sRGB texture compression is supported */\r\n    // eslint-disable-next-line @typescript-eslint/naming-convention\r\n    s3tc_srgb?: WEBGL_compressed_texture_s3tc_srgb;\r\n    /** Defines if pvrtc texture compression is supported */\r\n    pvrtc: any; //WEBGL_compressed_texture_pvrtc;\r\n    /** Defines if etc1 texture compression is supported */\r\n    etc1: any; //WEBGL_compressed_texture_etc1;\r\n    /** Defines if etc2 texture compression is supported */\r\n    etc2: any; //WEBGL_compressed_texture_etc;\r\n    /** Defines if astc texture compression is supported */\r\n    astc: any; //WEBGL_compressed_texture_astc;\r\n    /** Defines if bptc texture compression is supported */\r\n    bptc: any; //EXT_texture_compression_bptc;\r\n    /** Defines if float textures are supported */\r\n    textureFloat: boolean;\r\n    /** Defines if vertex array objects are supported */\r\n    vertexArrayObject: boolean;\r\n    /** Gets the webgl extension for anisotropic filtering (null if not supported) */\r\n    textureAnisotropicFilterExtension?: EXT_texture_filter_anisotropic;\r\n    /** Gets the maximum level of anisotropy supported */\r\n    maxAnisotropy: number;\r\n    /** Defines if instancing is supported */\r\n    instancedArrays: boolean;\r\n    /** Defines if 32 bits indices are supported */\r\n    uintIndices: boolean;\r\n    /** Defines if high precision shaders are supported */\r\n    highPrecisionShaderSupported: boolean;\r\n    /** Defines if depth reading in the fragment shader is supported */\r\n    fragmentDepthSupported: boolean;\r\n    /** Defines if float texture linear filtering is supported*/\r\n    textureFloatLinearFiltering: boolean;\r\n    /** Defines if rendering to float textures is supported */\r\n    textureFloatRender: boolean;\r\n    /** Defines if half float textures are supported*/\r\n    textureHalfFloat: boolean;\r\n    /** Defines if half float texture linear filtering is supported*/\r\n    textureHalfFloatLinearFiltering: boolean;\r\n    /** Defines if rendering to half float textures is supported */\r\n    textureHalfFloatRender: boolean;\r\n    /** Defines if textureLOD shader command is supported */\r\n    textureLOD: boolean;\r\n    /** Defines if texelFetch shader command is supported */\r\n    texelFetch: boolean;\r\n    /** Defines if draw buffers extension is supported */\r\n    drawBuffersExtension: boolean;\r\n    /** Defines if depth textures are supported */\r\n    depthTextureExtension: boolean;\r\n    /** Defines if float color buffer are supported */\r\n    colorBufferFloat: boolean;\r\n    /** Defines if half float color buffer are supported */\r\n    colorBufferHalfFloat?: boolean;\r\n    /** Gets disjoint timer query extension (null if not supported) */\r\n    timerQuery?: EXT_disjoint_timer_query;\r\n    /** Defines if timestamp can be used with timer query */\r\n    canUseTimestampForTimerQuery: boolean;\r\n    /** Defines if occlusion queries are supported by the engine */\r\n    supportOcclusionQuery: boolean;\r\n    /** Defines if multiview is supported (https://www.khronos.org/registry/webgl/extensions/WEBGL_multiview/) */\r\n    multiview?: any;\r\n    /** Defines if oculus multiview is supported (https://developer.oculus.com/documentation/oculus-browser/latest/concepts/browser-multiview/) */\r\n    oculusMultiview?: any;\r\n    /** Function used to let the system compiles shaders in background */\r\n    parallelShaderCompile?: {\r\n        // eslint-disable-next-line @typescript-eslint/naming-convention\r\n        COMPLETION_STATUS_KHR: number;\r\n    };\r\n    /** Max number of texture samples for MSAA */\r\n    maxMSAASamples: number;\r\n    /** Defines if the blend min max extension is supported */\r\n    blendMinMax: boolean;\r\n    /** In some iOS + WebGL1, gl_InstanceID (and gl_InstanceIDEXT) is undefined even if instancedArrays is true. So don't use gl_InstanceID in those cases */\r\n    canUseGLInstanceID: boolean;\r\n    /** Defines if gl_vertexID is available */\r\n    canUseGLVertexID: boolean;\r\n    /** Defines if compute shaders are supported by the engine */\r\n    supportComputeShaders: boolean;\r\n    /** Defines if sRGB texture formats are supported */\r\n    supportSRGBBuffers: boolean;\r\n    /** Defines if transform feedbacks are supported */\r\n    supportTransformFeedbacks: boolean;\r\n    /** Defines if texture max level are supported */\r\n    textureMaxLevel: boolean;\r\n\r\n    /** Defines the maximum layer count for a 2D Texture array. */\r\n    texture2DArrayMaxLayerCount: number;\r\n    /** Defines if the morph target texture is supported. */\r\n    disableMorphTargetTexture: boolean;\r\n    /** Defines if float textures like r32f, rg32f or rgba32f support being used as a resolve target */\r\n    supportFloatTexturesResolve: boolean;\r\n    /** Defines if RG11B10UFloat texture format is color renderable */\r\n    rg11b10ufColorRenderable: boolean;\r\n    /** Defines if EXT_texture_norm16 is available which enables the following texture formats: R16_EXT, RG16_EXT, RGB16_EXT, RGBA16_EXT, R16_SNORM_EXT, RG16_SNORM_EXT, RGB16_SNORM_EXT, RGBA16_SNORM_EXT */\r\n    textureNorm16: boolean;\r\n    /** Defines if blend parameters can be defined per target */\r\n    blendParametersPerTarget: boolean;\r\n    /** Defines if dual source blending is supported */\r\n    dualSourceBlending: boolean;\r\n}\r\n"]}
+{"version":3,"file":"engineCapabilities.js","sourceRoot":"","sources":["../../../../dev/core/src/Engines/engineCapabilities.ts"],"names":[],"mappings":"","sourcesContent":["/**\r\n * Interface used to describe the capabilities of the engine relatively to the current browser\r\n */\r\n// eslint-disable-next-line @typescript-eslint/naming-convention\r\nexport interface EngineCapabilities {\r\n    /** Maximum textures units per fragment shader */\r\n    maxTexturesImageUnits: number;\r\n    /** Maximum texture units per vertex shader */\r\n    maxVertexTextureImageUnits: number;\r\n    /** Maximum textures units in the entire pipeline */\r\n    maxCombinedTexturesImageUnits: number;\r\n    /** Maximum texture size */\r\n    maxTextureSize: number;\r\n    /** Maximum texture samples */\r\n    maxSamples?: number;\r\n    /** Maximum draw buffers */\r\n    maxDrawBuffers?: number;\r\n    /** Maximum cube texture size */\r\n    maxCubemapTextureSize: number;\r\n    /** Maximum render texture size */\r\n    maxRenderTextureSize: number;\r\n    /** Maximum number of vertex attributes */\r\n    maxVertexAttribs: number;\r\n    /** Maximum number of varyings */\r\n    maxVaryingVectors: number;\r\n    /** Maximum number of uniforms per vertex shader */\r\n    maxVertexUniformVectors: number;\r\n    /** Maximum number of uniforms per fragment shader */\r\n    maxFragmentUniformVectors: number;\r\n    /** The number of bits that can be accurately represented in shader floats */\r\n    shaderFloatPrecision: number;\r\n    /** Defines if standard derivatives (dx/dy) are supported */\r\n    standardDerivatives: boolean;\r\n    /** Defines if s3tc texture compression is supported */\r\n    s3tc?: WEBGL_compressed_texture_s3tc;\r\n    /** Defines if s3tc sRGB texture compression is supported */\r\n    // eslint-disable-next-line @typescript-eslint/naming-convention\r\n    s3tc_srgb?: WEBGL_compressed_texture_s3tc_srgb;\r\n    /** Defines if pvrtc texture compression is supported */\r\n    pvrtc: any; //WEBGL_compressed_texture_pvrtc;\r\n    /** Defines if etc1 texture compression is supported */\r\n    etc1: any; //WEBGL_compressed_texture_etc1;\r\n    /** Defines if etc2 texture compression is supported */\r\n    etc2: any; //WEBGL_compressed_texture_etc;\r\n    /** Defines if astc texture compression is supported */\r\n    astc: any; //WEBGL_compressed_texture_astc;\r\n    /** Defines if bptc texture compression is supported */\r\n    bptc: any; //EXT_texture_compression_bptc;\r\n    /** Defines if float textures are supported */\r\n    textureFloat: boolean;\r\n    /** Defines if vertex array objects are supported */\r\n    vertexArrayObject: boolean;\r\n    /** Gets the webgl extension for anisotropic filtering (null if not supported) */\r\n    textureAnisotropicFilterExtension?: EXT_texture_filter_anisotropic;\r\n    /** Gets the maximum level of anisotropy supported */\r\n    maxAnisotropy: number;\r\n    /** Defines if instancing is supported */\r\n    instancedArrays: boolean;\r\n    /** Defines if 32 bits indices are supported */\r\n    uintIndices: boolean;\r\n    /** Defines if high precision shaders are supported */\r\n    highPrecisionShaderSupported: boolean;\r\n    /** Defines if depth reading in the fragment shader is supported */\r\n    fragmentDepthSupported: boolean;\r\n    /** Defines if float texture linear filtering is supported*/\r\n    textureFloatLinearFiltering: boolean;\r\n    /** Defines if rendering to float textures is supported */\r\n    textureFloatRender: boolean;\r\n    /** Defines if half float textures are supported*/\r\n    textureHalfFloat: boolean;\r\n    /** Defines if half float texture linear filtering is supported*/\r\n    textureHalfFloatLinearFiltering: boolean;\r\n    /** Defines if rendering to half float textures is supported */\r\n    textureHalfFloatRender: boolean;\r\n    /** Defines if textureLOD shader command is supported */\r\n    textureLOD: boolean;\r\n    /** Defines if texelFetch shader command is supported */\r\n    texelFetch: boolean;\r\n    /** Defines if draw buffers extension is supported */\r\n    drawBuffersExtension: boolean;\r\n    /** Defines if depth textures are supported */\r\n    depthTextureExtension: boolean;\r\n    /** Defines if float color buffer are supported */\r\n    colorBufferFloat: boolean;\r\n    /** Defines if float color blending is supported */\r\n    blendFloat: boolean;\r\n    /** Defines if half float color buffer are supported */\r\n    colorBufferHalfFloat?: boolean;\r\n    /** Gets disjoint timer query extension (null if not supported) */\r\n    timerQuery?: EXT_disjoint_timer_query;\r\n    /** Defines if timestamp can be used with timer query */\r\n    canUseTimestampForTimerQuery: boolean;\r\n    /** Defines if occlusion queries are supported by the engine */\r\n    supportOcclusionQuery: boolean;\r\n    /** Defines if multiview is supported (https://www.khronos.org/registry/webgl/extensions/WEBGL_multiview/) */\r\n    multiview?: any;\r\n    /** Defines if oculus multiview is supported (https://developer.oculus.com/documentation/oculus-browser/latest/concepts/browser-multiview/) */\r\n    oculusMultiview?: any;\r\n    /** Function used to let the system compiles shaders in background */\r\n    parallelShaderCompile?: {\r\n        // eslint-disable-next-line @typescript-eslint/naming-convention\r\n        COMPLETION_STATUS_KHR: number;\r\n    };\r\n    /** Max number of texture samples for MSAA */\r\n    maxMSAASamples: number;\r\n    /** Defines if the blend min max extension is supported */\r\n    blendMinMax: boolean;\r\n    /** In some iOS + WebGL1, gl_InstanceID (and gl_InstanceIDEXT) is undefined even if instancedArrays is true. So don't use gl_InstanceID in those cases */\r\n    canUseGLInstanceID: boolean;\r\n    /** Defines if gl_vertexID is available */\r\n    canUseGLVertexID: boolean;\r\n    /** Defines if compute shaders are supported by the engine */\r\n    supportComputeShaders: boolean;\r\n    /** Defines if sRGB texture formats are supported */\r\n    supportSRGBBuffers: boolean;\r\n    /** Defines if transform feedbacks are supported */\r\n    supportTransformFeedbacks: boolean;\r\n    /** Defines if texture max level are supported */\r\n    textureMaxLevel: boolean;\r\n\r\n    /** Defines the maximum layer count for a 2D Texture array. */\r\n    texture2DArrayMaxLayerCount: number;\r\n    /** Defines if the morph target texture is supported. */\r\n    disableMorphTargetTexture: boolean;\r\n    /** Defines if float textures like r32f, rg32f or rgba32f support being used as a resolve target */\r\n    supportFloatTexturesResolve: boolean;\r\n    /** Defines if RG11B10UFloat texture format is color renderable */\r\n    rg11b10ufColorRenderable: boolean;\r\n    /** Defines if EXT_texture_norm16 is available which enables the following texture formats: R16_EXT, RG16_EXT, RGB16_EXT, RGBA16_EXT, R16_SNORM_EXT, RG16_SNORM_EXT, RGB16_SNORM_EXT, RGBA16_SNORM_EXT */\r\n    textureNorm16: boolean;\r\n    /** Defines if blend parameters can be defined per target */\r\n    blendParametersPerTarget: boolean;\r\n    /** Defines if dual source blending is supported */\r\n    dualSourceBlending: boolean;\r\n}\r\n"]}

package/Engines/engineFactory.d.ts

@@ -1,4 +1,7 @@
 import type { AbstractEngine } from "./abstractEngine.js";
+import { type NullEngineOptions } from "./nullEngine.js";
+import { type WebGPUEngineOptions } from "./webgpuEngine.js";
+import type { EngineOptions } from "./thinEngine.js";
 /**
  * Helper class to create the best engine depending on the current hardware
  */
@@ -9,5 +12,5 @@ export declare class EngineFactory {
      * @param options Defines the options passed to the engine to create the context dependencies
      * @returns a promise that resolves with the created engine
      */
-    static CreateAsync(canvas: HTMLCanvasElement, options: any): Promise<AbstractEngine>;
+    static CreateAsync(canvas: HTMLCanvasElement, options?: WebGPUEngineOptions | EngineOptions | NullEngineOptions): Promise<AbstractEngine>;
 }

package/Engines/engineFactory.js.map

@@ -1 +1 @@
-{"version":3,"file":"engineFactory.js","sourceRoot":"","sources":["../../../../dev/core/src/Engines/engineFactory.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C;;GAEG;AACH,MAAM,OAAO,aAAa;IACtB;;;;;OAKG;IACI,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,MAAyB,EAAE,OAAY;QACnE,MAAM,SAAS,GAAG,MAAM,YAAY,CAAC,gBAAgB,CAAC;QACtD,IAAI,SAAS,EAAE,CAAC;YACZ,OAAO,MAAM,YAAY,CAAC,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC3D,CAAC;QACD,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;YACrB,OAAO,IAAI,MAAM,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;QAClD,CAAC;QACD,OAAO,IAAI,UAAU,CAAC,OAAO,CAAC,CAAC;IACnC,CAAC;CACJ","sourcesContent":["import type { AbstractEngine } from \"./abstractEngine\";\r\nimport { Engine } from \"./engine\";\r\nimport { NullEngine } from \"./nullEngine\";\r\nimport { WebGPUEngine } from \"./webgpuEngine\";\r\n\r\n/**\r\n * Helper class to create the best engine depending on the current hardware\r\n */\r\nexport class EngineFactory {\r\n    /**\r\n     * Creates an engine based on the capabilities of the underlying hardware\r\n     * @param canvas Defines the canvas to use to display the result\r\n     * @param options Defines the options passed to the engine to create the context dependencies\r\n     * @returns a promise that resolves with the created engine\r\n     */\r\n    public static async CreateAsync(canvas: HTMLCanvasElement, options: any): Promise<AbstractEngine> {\r\n        const supported = await WebGPUEngine.IsSupportedAsync;\r\n        if (supported) {\r\n            return await WebGPUEngine.CreateAsync(canvas, options);\r\n        }\r\n        if (Engine.IsSupported) {\r\n            return new Engine(canvas, undefined, options);\r\n        }\r\n        return new NullEngine(options);\r\n    }\r\n}\r\n"]}
+{"version":3,"file":"engineFactory.js","sourceRoot":"","sources":["../../../../dev/core/src/Engines/engineFactory.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,UAAU,EAA0B,MAAM,cAAc,CAAC;AAClE,OAAO,EAAE,YAAY,EAA4B,MAAM,gBAAgB,CAAC;AAGxE;;GAEG;AACH,MAAM,OAAO,aAAa;IACtB;;;;;OAKG;IACI,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,MAAyB,EAAE,OAAiE;QACxH,MAAM,SAAS,GAAG,MAAM,YAAY,CAAC,gBAAgB,CAAC;QACtD,IAAI,SAAS,EAAE,CAAC;YACZ,OAAO,MAAM,YAAY,CAAC,WAAW,CAAC,MAAM,EAAE,OAA8B,CAAC,CAAC;QAClF,CAAC;QACD,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;YACrB,OAAO,IAAI,MAAM,CAAC,MAAM,EAAE,SAAS,EAAE,OAAwB,CAAC,CAAC;QACnE,CAAC;QACD,OAAO,IAAI,UAAU,CAAC,OAA4B,CAAC,CAAC;IACxD,CAAC;CACJ","sourcesContent":["import type { AbstractEngine } from \"./abstractEngine\";\r\nimport { Engine } from \"./engine\";\r\nimport { NullEngine, type NullEngineOptions } from \"./nullEngine\";\r\nimport { WebGPUEngine, type WebGPUEngineOptions } from \"./webgpuEngine\";\r\nimport type { EngineOptions } from \"./thinEngine\";\r\n\r\n/**\r\n * Helper class to create the best engine depending on the current hardware\r\n */\r\nexport class EngineFactory {\r\n    /**\r\n     * Creates an engine based on the capabilities of the underlying hardware\r\n     * @param canvas Defines the canvas to use to display the result\r\n     * @param options Defines the options passed to the engine to create the context dependencies\r\n     * @returns a promise that resolves with the created engine\r\n     */\r\n    public static async CreateAsync(canvas: HTMLCanvasElement, options?: WebGPUEngineOptions | EngineOptions | NullEngineOptions): Promise<AbstractEngine> {\r\n        const supported = await WebGPUEngine.IsSupportedAsync;\r\n        if (supported) {\r\n            return await WebGPUEngine.CreateAsync(canvas, options as WebGPUEngineOptions);\r\n        }\r\n        if (Engine.IsSupported) {\r\n            return new Engine(canvas, undefined, options as EngineOptions);\r\n        }\r\n        return new NullEngine(options as NullEngineOptions);\r\n    }\r\n}\r\n"]}

package/Engines/nativeEngine.js

@@ -175,6 +175,7 @@ export class NativeEngine extends Engine {
             maxDrawBuffers: 8,
             maxFragmentUniformVectors: 16,
             maxVertexUniformVectors: 16,
+            shaderFloatPrecision: 23, // TODO: is this correct?
             standardDerivatives: true,
             astc: null,
             pvrtc: null,
@@ -186,6 +187,7 @@ export class NativeEngine extends Engine {
             fragmentDepthSupported: false,
             highPrecisionShaderSupported: true,
             colorBufferFloat: false,
+            blendFloat: false,
             supportFloatTexturesResolve: false,
             rg11b10ufColorRenderable: false,
             textureFloat: true,