@itwin/webgl-compatibility 4.0.0-dev.52 → 4.0.0-dev.55

package/lib/cjs/RenderCompatibility.js

@@ -1,119 +1,119 @@
-"use strict";
-/*---------------------------------------------------------------------------------------------
-* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
-* See LICENSE.md in the project root for license terms and full copyright notice.
-*--------------------------------------------------------------------------------------------*/
-/** @packageDocumentation
- * @module Compatibility
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.queryRenderCompatibility = exports.WebGLRenderCompatibilityStatus = exports.WebGLFeature = void 0;
-const Capabilities_1 = require("./Capabilities");
-/** Enumerates the required and optional WebGL features used by the [RenderSystem]($frontend).
- * @public
- */
-var WebGLFeature;
-(function (WebGLFeature) {
-    /** This feature allows transparent geometry to be rendered more efficiently, using 1 pass instead of 2. */
-    WebGLFeature["MrtTransparency"] = "mrt transparency";
-    /** This feature allows picking to occur more efficiently, using 1 pass instead of 3. */
-    WebGLFeature["MrtPick"] = "mrt pick";
-    /** This feature ensures large meshes (with more than 21,845 triangles) can be rendered. */
-    WebGLFeature["UintElementIndex"] = "uint element index";
-    /** This feature allows transparency to achieve the optimal quality. Without this feature, overlapping transparent geometry will "wash out" more easily. */
-    WebGLFeature["FloatRendering"] = "float rendering";
-    /** This feature allows for the display of non-3D classification data and solar shadows. */
-    WebGLFeature["DepthTexture"] = "depth texture";
-    /** This feature allows instancing of repeated geometry, which can reduce memory consumption. */
-    WebGLFeature["Instancing"] = "instancing";
-    /** This feature indicates that the system has enough texture units available for the shaders to run properly. */
-    WebGLFeature["MinimalTextureUnits"] = "minimal texture units";
-    /** Indicates that shadow maps are supported. Without this feature, shadows cannot be displayed. */
-    WebGLFeature["ShadowMaps"] = "shadow maps";
-    /** This feature allows a logarithmic depth buffer to be used. Without this feature, z-fighting will be much more likely to occur. */
-    WebGLFeature["FragDepth"] = "fragment depth";
-    /** This feature allows the renderer to achieve accurate contour lines for isoline and stepped delimiter modes of thematic display. */
-    WebGLFeature["StandardDerivatives"] = "standard derivatives";
-    /** This feature allows the renderer to smooth curved lines. */
-    WebGLFeature["AntiAliasing"] = "anti-aliasing";
-})(WebGLFeature = exports.WebGLFeature || (exports.WebGLFeature = {}));
-/** An enumeration that describes a general "compatibility rating" based on the contents of a [[WebGLRenderCompatibilityInfo]].
- * @public
- */
-var WebGLRenderCompatibilityStatus;
-(function (WebGLRenderCompatibilityStatus) {
-    /**
-     * Signifies that everything is ideal: context created successfully, all required and optional features are available,
-     * and browser did not signal a major performance caveat.
-     */
-    WebGLRenderCompatibilityStatus[WebGLRenderCompatibilityStatus["AllOkay"] = 0] = "AllOkay";
-    /**
-     * Signifies that the base requirements of compatibility are met but at least some optional features are missing.
-     * Consult the contents of [[WebGLRenderCompatibilityInfo.missingOptionalFeatures]].
-     */
-    WebGLRenderCompatibilityStatus[WebGLRenderCompatibilityStatus["MissingOptionalFeatures"] = 1] = "MissingOptionalFeatures";
-    /**
-     * Signifies that the base requirements of compatibility are met but WebGL reported a major performance caveat.  The browser
-     * has likely fallen back to software rendering due to lack of a usable GPU.
-     * Consult [[WebGLRenderCompatibilityInfo.contextErrorMessage]] for a possible description of what went wrong.
-     * There could also be some missing optional features; consult the contents of [[WebGLRenderCompatibilityInfo.missingOptionalFeatures]].
-     */
-    WebGLRenderCompatibilityStatus[WebGLRenderCompatibilityStatus["MajorPerformanceCaveat"] = 2] = "MajorPerformanceCaveat";
-    /**
-     * Signifies that the base requirements of compatibility are not met; rendering cannot occur.
-     * Consult the contents of [[WebGLRenderCompatibilityInfo.missingRequiredFeatures]].
-     */
-    WebGLRenderCompatibilityStatus[WebGLRenderCompatibilityStatus["MissingRequiredFeatures"] = 3] = "MissingRequiredFeatures";
-    /**
-     * Signifies an inability to create either a canvas or a WebGL rendering context; rendering cannot occur.  Consult
-     * [[WebGLRenderCompatibilityInfo.contextErrorMessage]] for a possible description of what went wrong.
-     */
-    WebGLRenderCompatibilityStatus[WebGLRenderCompatibilityStatus["CannotCreateContext"] = 4] = "CannotCreateContext";
-})(WebGLRenderCompatibilityStatus = exports.WebGLRenderCompatibilityStatus || (exports.WebGLRenderCompatibilityStatus = {}));
-function createDefaultContext(canvas, useWebGL2 = true, attributes) {
-    let context = useWebGL2 ? canvas.getContext("webgl2", attributes) : canvas.getContext("webgl", attributes);
-    if (context === null && useWebGL2)
-        context = canvas.getContext("webgl", attributes);
-    return context ?? undefined;
-}
-/** This function returns information about the client system's level of compatibility with the iTwin.js rendering system, describing the client system's support for both optional and required features. It will also report if there is a major issue with the client system such as the browser falling back to software rendering or an inability to create a either a canvas or a WebGL rendering context.
- * @param useWebGL2 A boolean which will be passed to the createContext function in order to create the desired type of context; set this to `true` to use WebGL2, `false` to use WebGL1.
- * @param createContext A function of type [[ContextCreator]] that returns a WebGLContext. If not specified, this by default uses `canvas.getContext()` to create the WebGLContext.
- * @returns A [[WebGLRenderCompatibilityInfo]] object which contains a compatibility summary.
- * @see [[WebGLRenderCompatibilityInfo]]
- * @public
- */
-function queryRenderCompatibility(useWebGL2, createContext) {
-    const canvas = document.createElement("canvas");
-    if (null === canvas)
-        return { status: WebGLRenderCompatibilityStatus.CannotCreateContext, missingOptionalFeatures: [], missingRequiredFeatures: [], userAgent: navigator.userAgent, driverBugs: {} };
-    let errorMessage;
-    canvas.addEventListener("webglcontextcreationerror", (event) => {
-        errorMessage = event.statusMessage || "webglcontextcreationerror was triggered with no error provided";
-    }, false);
-    if (undefined === createContext)
-        createContext = createDefaultContext;
-    let hasMajorPerformanceCaveat = false;
-    let context = createContext(canvas, useWebGL2, { failIfMajorPerformanceCaveat: true });
-    if (undefined === context) {
-        hasMajorPerformanceCaveat = true;
-        context = createContext(canvas, useWebGL2); // try to create context without black-listed GPU
-        if (undefined === context)
-            return {
-                status: WebGLRenderCompatibilityStatus.CannotCreateContext,
-                missingOptionalFeatures: [],
-                missingRequiredFeatures: [],
-                userAgent: navigator.userAgent,
-                contextErrorMessage: errorMessage,
-                driverBugs: {},
-            };
-    }
-    const capabilities = new Capabilities_1.Capabilities();
-    const compatibility = capabilities.init(context, undefined);
-    compatibility.contextErrorMessage = errorMessage;
-    if (hasMajorPerformanceCaveat && compatibility.status !== WebGLRenderCompatibilityStatus.MissingRequiredFeatures)
-        compatibility.status = WebGLRenderCompatibilityStatus.MajorPerformanceCaveat;
-    return compatibility;
-}
-exports.queryRenderCompatibility = queryRenderCompatibility;
+"use strict";
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+/** @packageDocumentation
+ * @module Compatibility
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.queryRenderCompatibility = exports.WebGLRenderCompatibilityStatus = exports.WebGLFeature = void 0;
+const Capabilities_1 = require("./Capabilities");
+/** Enumerates the required and optional WebGL features used by the [RenderSystem]($frontend).
+ * @public
+ */
+var WebGLFeature;
+(function (WebGLFeature) {
+    /** This feature allows transparent geometry to be rendered more efficiently, using 1 pass instead of 2. */
+    WebGLFeature["MrtTransparency"] = "mrt transparency";
+    /** This feature allows picking to occur more efficiently, using 1 pass instead of 3. */
+    WebGLFeature["MrtPick"] = "mrt pick";
+    /** This feature ensures large meshes (with more than 21,845 triangles) can be rendered. */
+    WebGLFeature["UintElementIndex"] = "uint element index";
+    /** This feature allows transparency to achieve the optimal quality. Without this feature, overlapping transparent geometry will "wash out" more easily. */
+    WebGLFeature["FloatRendering"] = "float rendering";
+    /** This feature allows for the display of non-3D classification data and solar shadows. */
+    WebGLFeature["DepthTexture"] = "depth texture";
+    /** This feature allows instancing of repeated geometry, which can reduce memory consumption. */
+    WebGLFeature["Instancing"] = "instancing";
+    /** This feature indicates that the system has enough texture units available for the shaders to run properly. */
+    WebGLFeature["MinimalTextureUnits"] = "minimal texture units";
+    /** Indicates that shadow maps are supported. Without this feature, shadows cannot be displayed. */
+    WebGLFeature["ShadowMaps"] = "shadow maps";
+    /** This feature allows a logarithmic depth buffer to be used. Without this feature, z-fighting will be much more likely to occur. */
+    WebGLFeature["FragDepth"] = "fragment depth";
+    /** This feature allows the renderer to achieve accurate contour lines for isoline and stepped delimiter modes of thematic display. */
+    WebGLFeature["StandardDerivatives"] = "standard derivatives";
+    /** This feature allows the renderer to smooth curved lines. */
+    WebGLFeature["AntiAliasing"] = "anti-aliasing";
+})(WebGLFeature = exports.WebGLFeature || (exports.WebGLFeature = {}));
+/** An enumeration that describes a general "compatibility rating" based on the contents of a [[WebGLRenderCompatibilityInfo]].
+ * @public
+ */
+var WebGLRenderCompatibilityStatus;
+(function (WebGLRenderCompatibilityStatus) {
+    /**
+     * Signifies that everything is ideal: context created successfully, all required and optional features are available,
+     * and browser did not signal a major performance caveat.
+     */
+    WebGLRenderCompatibilityStatus[WebGLRenderCompatibilityStatus["AllOkay"] = 0] = "AllOkay";
+    /**
+     * Signifies that the base requirements of compatibility are met but at least some optional features are missing.
+     * Consult the contents of [[WebGLRenderCompatibilityInfo.missingOptionalFeatures]].
+     */
+    WebGLRenderCompatibilityStatus[WebGLRenderCompatibilityStatus["MissingOptionalFeatures"] = 1] = "MissingOptionalFeatures";
+    /**
+     * Signifies that the base requirements of compatibility are met but WebGL reported a major performance caveat.  The browser
+     * has likely fallen back to software rendering due to lack of a usable GPU.
+     * Consult [[WebGLRenderCompatibilityInfo.contextErrorMessage]] for a possible description of what went wrong.
+     * There could also be some missing optional features; consult the contents of [[WebGLRenderCompatibilityInfo.missingOptionalFeatures]].
+     */
+    WebGLRenderCompatibilityStatus[WebGLRenderCompatibilityStatus["MajorPerformanceCaveat"] = 2] = "MajorPerformanceCaveat";
+    /**
+     * Signifies that the base requirements of compatibility are not met; rendering cannot occur.
+     * Consult the contents of [[WebGLRenderCompatibilityInfo.missingRequiredFeatures]].
+     */
+    WebGLRenderCompatibilityStatus[WebGLRenderCompatibilityStatus["MissingRequiredFeatures"] = 3] = "MissingRequiredFeatures";
+    /**
+     * Signifies an inability to create either a canvas or a WebGL rendering context; rendering cannot occur.  Consult
+     * [[WebGLRenderCompatibilityInfo.contextErrorMessage]] for a possible description of what went wrong.
+     */
+    WebGLRenderCompatibilityStatus[WebGLRenderCompatibilityStatus["CannotCreateContext"] = 4] = "CannotCreateContext";
+})(WebGLRenderCompatibilityStatus = exports.WebGLRenderCompatibilityStatus || (exports.WebGLRenderCompatibilityStatus = {}));
+function createDefaultContext(canvas, useWebGL2 = true, attributes) {
+    let context = useWebGL2 ? canvas.getContext("webgl2", attributes) : canvas.getContext("webgl", attributes);
+    if (context === null && useWebGL2)
+        context = canvas.getContext("webgl", attributes);
+    return context ?? undefined;
+}
+/** This function returns information about the client system's level of compatibility with the iTwin.js rendering system, describing the client system's support for both optional and required features. It will also report if there is a major issue with the client system such as the browser falling back to software rendering or an inability to create a either a canvas or a WebGL rendering context.
+ * @param useWebGL2 A boolean which will be passed to the createContext function in order to create the desired type of context; set this to `true` to use WebGL2, `false` to use WebGL1.
+ * @param createContext A function of type [[ContextCreator]] that returns a WebGLContext. If not specified, this by default uses `canvas.getContext()` to create the WebGLContext.
+ * @returns A [[WebGLRenderCompatibilityInfo]] object which contains a compatibility summary.
+ * @see [[WebGLRenderCompatibilityInfo]]
+ * @public
+ */
+function queryRenderCompatibility(useWebGL2, createContext) {
+    const canvas = document.createElement("canvas");
+    if (null === canvas)
+        return { status: WebGLRenderCompatibilityStatus.CannotCreateContext, missingOptionalFeatures: [], missingRequiredFeatures: [], userAgent: navigator.userAgent, driverBugs: {} };
+    let errorMessage;
+    canvas.addEventListener("webglcontextcreationerror", (event) => {
+        errorMessage = event.statusMessage || "webglcontextcreationerror was triggered with no error provided";
+    }, false);
+    if (undefined === createContext)
+        createContext = createDefaultContext;
+    let hasMajorPerformanceCaveat = false;
+    let context = createContext(canvas, useWebGL2, { failIfMajorPerformanceCaveat: true });
+    if (undefined === context) {
+        hasMajorPerformanceCaveat = true;
+        context = createContext(canvas, useWebGL2); // try to create context without black-listed GPU
+        if (undefined === context)
+            return {
+                status: WebGLRenderCompatibilityStatus.CannotCreateContext,
+                missingOptionalFeatures: [],
+                missingRequiredFeatures: [],
+                userAgent: navigator.userAgent,
+                contextErrorMessage: errorMessage,
+                driverBugs: {},
+            };
+    }
+    const capabilities = new Capabilities_1.Capabilities();
+    const compatibility = capabilities.init(context, undefined);
+    compatibility.contextErrorMessage = errorMessage;
+    if (hasMajorPerformanceCaveat && compatibility.status !== WebGLRenderCompatibilityStatus.MissingRequiredFeatures)
+        compatibility.status = WebGLRenderCompatibilityStatus.MajorPerformanceCaveat;
+    return compatibility;
+}
+exports.queryRenderCompatibility = queryRenderCompatibility;
 //# sourceMappingURL=RenderCompatibility.js.map

package/lib/cjs/webgl-compatibility.d.ts

@@ -1,10 +1,10 @@
-export * from "./Capabilities";
-export * from "./RenderCompatibility";
-/** @docs-package-description
- * The webgl-compatibility package provides APIs for determining the level of compatibility of a browser+device with the iTwin.js rendering system.
- */
-/**
- * @docs-group-description Compatibility
- * APIs for evaluating compatibility with the iTwin.js rendering system.
- */
+export * from "./Capabilities";
+export * from "./RenderCompatibility";
+/** @docs-package-description
+ * The webgl-compatibility package provides APIs for determining the level of compatibility of a browser+device with the iTwin.js rendering system.
+ */
+/**
+ * @docs-group-description Compatibility
+ * APIs for evaluating compatibility with the iTwin.js rendering system.
+ */
 //# sourceMappingURL=webgl-compatibility.d.ts.map

package/lib/cjs/webgl-compatibility.js

@@ -1,26 +1,30 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    Object.defineProperty(o, k2, { enumerable: true, get: function() { return m[k]; } });
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-/*---------------------------------------------------------------------------------------------
-* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
-* See LICENSE.md in the project root for license terms and full copyright notice.
-*--------------------------------------------------------------------------------------------*/
-__exportStar(require("./Capabilities"), exports);
-__exportStar(require("./RenderCompatibility"), exports);
-/** @docs-package-description
- * The webgl-compatibility package provides APIs for determining the level of compatibility of a browser+device with the iTwin.js rendering system.
- */
-/**
- * @docs-group-description Compatibility
- * APIs for evaluating compatibility with the iTwin.js rendering system.
- */
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+__exportStar(require("./Capabilities"), exports);
+__exportStar(require("./RenderCompatibility"), exports);
+/** @docs-package-description
+ * The webgl-compatibility package provides APIs for determining the level of compatibility of a browser+device with the iTwin.js rendering system.
+ */
+/**
+ * @docs-group-description Compatibility
+ * APIs for evaluating compatibility with the iTwin.js rendering system.
+ */
 //# sourceMappingURL=webgl-compatibility.js.map

package/lib/cjs/webgl-compatibility.js.map

@@ -1 +1 @@
-{"version":3,"file":"webgl-compatibility.js","sourceRoot":"","sources":["../../src/webgl-compatibility.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA;;;+FAG+F;AAC/F,iDAA+B;AAC/B,wDAAsC;AAEtC;;GAEG;AAEH;;;GAGG","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\nexport * from \"./Capabilities\";\r\nexport * from \"./RenderCompatibility\";\r\n\r\n/** @docs-package-description\r\n * The webgl-compatibility package provides APIs for determining the level of compatibility of a browser+device with the iTwin.js rendering system.\r\n */\r\n\r\n/**\r\n * @docs-group-description Compatibility\r\n * APIs for evaluating compatibility with the iTwin.js rendering system.\r\n */\r\n"]}
+{"version":3,"file":"webgl-compatibility.js","sourceRoot":"","sources":["../../src/webgl-compatibility.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA;;;+FAG+F;AAC/F,iDAA+B;AAC/B,wDAAsC;AAEtC;;GAEG;AAEH;;;GAGG","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\nexport * from \"./Capabilities\";\r\nexport * from \"./RenderCompatibility\";\r\n\r\n/** @docs-package-description\r\n * The webgl-compatibility package provides APIs for determining the level of compatibility of a browser+device with the iTwin.js rendering system.\r\n */\r\n\r\n/**\r\n * @docs-group-description Compatibility\r\n * APIs for evaluating compatibility with the iTwin.js rendering system.\r\n */\r\n"]}

package/lib/esm/Capabilities.d.ts

@@ -1,104 +1,104 @@
-/** @packageDocumentation
- * @module Compatibility
- */
-import { GraphicsDriverBugs, WebGLContext, WebGLFeature, WebGLRenderCompatibilityInfo } from "./RenderCompatibility";
-/** @internal */
-export declare type WebGLExtensionName = "WEBGL_draw_buffers" | "OES_element_index_uint" | "OES_texture_float" | "OES_texture_float_linear" | "OES_texture_half_float" | "OES_texture_half_float_linear" | "EXT_texture_filter_anisotropic" | "WEBGL_depth_texture" | "EXT_color_buffer_float" | "EXT_shader_texture_lod" | "ANGLE_instanced_arrays" | "OES_vertex_array_object" | "WEBGL_lose_context" | "EXT_frag_depth" | "EXT_disjoint_timer_query" | "EXT_disjoint_timer_query_webgl2" | "OES_standard_derivatives" | "EXT_float_blend";
-/** Describes the type of a render target. Used by Capabilities to represent maximum precision render target available on host system.
- * @internal
- */
-export declare enum RenderType {
-    TextureUnsignedByte = 0,
-    TextureHalfFloat = 1,
-    TextureFloat = 2
-}
-/**
- * Describes the type of a depth buffer. Used by Capabilities to represent maximum depth buffer precision available on host system.
- * Note: the commented-out values are unimplemented but left in place for reference, in case desired for future implementation.
- * @internal
- */
-export declare enum DepthType {
-    RenderBufferUnsignedShort16 = 0,
-    TextureUnsignedInt24Stencil8 = 1,
-    TextureUnsignedInt32 = 2
-}
-/** Describes the rendering capabilities of the host system.
- * @internal
- */
-export declare class Capabilities {
-    private _maxRenderType;
-    private _maxDepthType;
-    private _maxTextureSize;
-    private _maxColorAttachments;
-    private _maxDrawBuffers;
-    private _maxFragTextureUnits;
-    private _maxVertTextureUnits;
-    private _maxVertAttribs;
-    private _maxVertUniformVectors;
-    private _maxVaryingVectors;
-    private _maxFragUniformVectors;
-    private _maxAnisotropy?;
-    private _maxAntialiasSamples;
-    private _supportsCreateImageBitmap;
-    private _maxTexSizeAllow;
-    private _extensionMap;
-    private _presentFeatures;
-    private _isWebGL2;
-    private _isMobile;
-    private _driverBugs;
-    get maxRenderType(): RenderType;
-    get maxDepthType(): DepthType;
-    get maxTextureSize(): number;
-    get maxTexSizeAllow(): number;
-    get supportsCreateImageBitmap(): boolean;
-    get maxColorAttachments(): number;
-    get maxDrawBuffers(): number;
-    get maxFragTextureUnits(): number;
-    get maxVertTextureUnits(): number;
-    get maxVertAttribs(): number;
-    get maxVertUniformVectors(): number;
-    get maxVaryingVectors(): number;
-    get maxFragUniformVectors(): number;
-    get maxAntialiasSamples(): number;
-    get isWebGL2(): boolean;
-    get driverBugs(): GraphicsDriverBugs;
-    /** These getters check for existence of extension objects to determine availability of features.  In WebGL2, could just return true for some. */
-    get supportsNonPowerOf2Textures(): boolean;
-    get supportsDrawBuffers(): boolean;
-    get supportsInstancing(): boolean;
-    get supports32BitElementIndex(): boolean;
-    get supportsTextureFloat(): boolean;
-    get supportsTextureFloatLinear(): boolean;
-    get supportsTextureHalfFloat(): boolean;
-    get supportsTextureHalfFloatLinear(): boolean;
-    get supportsTextureFilterAnisotropic(): boolean;
-    get supportsShaderTextureLOD(): boolean;
-    get supportsVertexArrayObjects(): boolean;
-    get supportsFragDepth(): boolean;
-    get supportsDisjointTimerQuery(): boolean;
-    get supportsStandardDerivatives(): boolean;
-    get supportsMRTTransparency(): boolean;
-    get supportsMRTPickShaders(): boolean;
-    get supportsShadowMaps(): boolean;
-    get supportsAntiAliasing(): boolean;
-    get isMobile(): boolean;
-    private findExtension;
-    /** Queries an extension object if available.  This is necessary for other parts of the system to access some constants within extensions. */
-    queryExtensionObject<T>(ext: WebGLExtensionName): T | undefined;
-    static readonly optionalFeatures: WebGLFeature[];
-    static readonly requiredFeatures: WebGLFeature[];
-    private get _hasRequiredTextureUnits();
-    /** Return an array containing any features not supported by the system as compared to the input array. */
-    private _findMissingFeatures;
-    /** Populate and return an array containing features that this system supports. */
-    private _gatherFeatures;
-    /** Retrieve compatibility status based on presence of various features. */
-    private _getCompatibilityStatus;
-    /** Initializes the capabilities based on a GL context. Must be called first. */
-    init(gl: WebGLContext, disabledExtensions?: WebGLExtensionName[]): WebGLRenderCompatibilityInfo;
-    static create(gl: WebGLContext, disabledExtensions?: WebGLExtensionName[]): Capabilities | undefined;
-    /** Determines if a particular texture type is color-renderable on the host system. */
-    private isTextureRenderable;
-    setMaxAnisotropy(desiredMax: number | undefined, gl: WebGLContext): void;
-}
+/** @packageDocumentation
+ * @module Compatibility
+ */
+import { GraphicsDriverBugs, WebGLContext, WebGLFeature, WebGLRenderCompatibilityInfo } from "./RenderCompatibility";
+/** @internal */
+export type WebGLExtensionName = "WEBGL_draw_buffers" | "OES_element_index_uint" | "OES_texture_float" | "OES_texture_float_linear" | "OES_texture_half_float" | "OES_texture_half_float_linear" | "EXT_texture_filter_anisotropic" | "WEBGL_depth_texture" | "EXT_color_buffer_float" | "EXT_shader_texture_lod" | "ANGLE_instanced_arrays" | "OES_vertex_array_object" | "WEBGL_lose_context" | "EXT_frag_depth" | "EXT_disjoint_timer_query" | "EXT_disjoint_timer_query_webgl2" | "OES_standard_derivatives" | "EXT_float_blend";
+/** Describes the type of a render target. Used by Capabilities to represent maximum precision render target available on host system.
+ * @internal
+ */
+export declare enum RenderType {
+    TextureUnsignedByte = 0,
+    TextureHalfFloat = 1,
+    TextureFloat = 2
+}
+/**
+ * Describes the type of a depth buffer. Used by Capabilities to represent maximum depth buffer precision available on host system.
+ * Note: the commented-out values are unimplemented but left in place for reference, in case desired for future implementation.
+ * @internal
+ */
+export declare enum DepthType {
+    RenderBufferUnsignedShort16 = 0,
+    TextureUnsignedInt24Stencil8 = 1,
+    TextureUnsignedInt32 = 2
+}
+/** Describes the rendering capabilities of the host system.
+ * @internal
+ */
+export declare class Capabilities {
+    private _maxRenderType;
+    private _maxDepthType;
+    private _maxTextureSize;
+    private _maxColorAttachments;
+    private _maxDrawBuffers;
+    private _maxFragTextureUnits;
+    private _maxVertTextureUnits;
+    private _maxVertAttribs;
+    private _maxVertUniformVectors;
+    private _maxVaryingVectors;
+    private _maxFragUniformVectors;
+    private _maxAnisotropy?;
+    private _maxAntialiasSamples;
+    private _supportsCreateImageBitmap;
+    private _maxTexSizeAllow;
+    private _extensionMap;
+    private _presentFeatures;
+    private _isWebGL2;
+    private _isMobile;
+    private _driverBugs;
+    get maxRenderType(): RenderType;
+    get maxDepthType(): DepthType;
+    get maxTextureSize(): number;
+    get maxTexSizeAllow(): number;
+    get supportsCreateImageBitmap(): boolean;
+    get maxColorAttachments(): number;
+    get maxDrawBuffers(): number;
+    get maxFragTextureUnits(): number;
+    get maxVertTextureUnits(): number;
+    get maxVertAttribs(): number;
+    get maxVertUniformVectors(): number;
+    get maxVaryingVectors(): number;
+    get maxFragUniformVectors(): number;
+    get maxAntialiasSamples(): number;
+    get isWebGL2(): boolean;
+    get driverBugs(): GraphicsDriverBugs;
+    /** These getters check for existence of extension objects to determine availability of features.  In WebGL2, could just return true for some. */
+    get supportsNonPowerOf2Textures(): boolean;
+    get supportsDrawBuffers(): boolean;
+    get supportsInstancing(): boolean;
+    get supports32BitElementIndex(): boolean;
+    get supportsTextureFloat(): boolean;
+    get supportsTextureFloatLinear(): boolean;
+    get supportsTextureHalfFloat(): boolean;
+    get supportsTextureHalfFloatLinear(): boolean;
+    get supportsTextureFilterAnisotropic(): boolean;
+    get supportsShaderTextureLOD(): boolean;
+    get supportsVertexArrayObjects(): boolean;
+    get supportsFragDepth(): boolean;
+    get supportsDisjointTimerQuery(): boolean;
+    get supportsStandardDerivatives(): boolean;
+    get supportsMRTTransparency(): boolean;
+    get supportsMRTPickShaders(): boolean;
+    get supportsShadowMaps(): boolean;
+    get supportsAntiAliasing(): boolean;
+    get isMobile(): boolean;
+    private findExtension;
+    /** Queries an extension object if available.  This is necessary for other parts of the system to access some constants within extensions. */
+    queryExtensionObject<T>(ext: WebGLExtensionName): T | undefined;
+    static readonly optionalFeatures: WebGLFeature[];
+    static readonly requiredFeatures: WebGLFeature[];
+    private get _hasRequiredTextureUnits();
+    /** Return an array containing any features not supported by the system as compared to the input array. */
+    private _findMissingFeatures;
+    /** Populate and return an array containing features that this system supports. */
+    private _gatherFeatures;
+    /** Retrieve compatibility status based on presence of various features. */
+    private _getCompatibilityStatus;
+    /** Initializes the capabilities based on a GL context. Must be called first. */
+    init(gl: WebGLContext, disabledExtensions?: WebGLExtensionName[]): WebGLRenderCompatibilityInfo;
+    static create(gl: WebGLContext, disabledExtensions?: WebGLExtensionName[]): Capabilities | undefined;
+    /** Determines if a particular texture type is color-renderable on the host system. */
+    private isTextureRenderable;
+    setMaxAnisotropy(desiredMax: number | undefined, gl: WebGLContext): void;
+}
 //# sourceMappingURL=Capabilities.d.ts.map

package/lib/esm/Capabilities.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Capabilities.d.ts","sourceRoot":"","sources":["../../src/Capabilities.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"Capabilities.d.ts","sourceRoot":"","sources":["../../src/Capabilities.ts"],"names":[],"mappings":"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"}