@luma.gl/core 9.2.0-alpha.1 → 9.2.0-alpha.5

package/dist/shadertypes/textures/texture-formats.d.ts

@@ -0,0 +1,90 @@
+import { NormalizedDataType } from "../data-types/data-types.js";
+/** Information about the structure of a texture format */
+export type TextureFormatInfo = {
+    /** The format that is described */
+    format: TextureFormat;
+    /** Color or depth stencil attachment formats */
+    attachment?: 'color' | 'depth' | 'stencil' | 'depth-stencil';
+    /** String describing which channels this texture has */
+    channels: 'r' | 'rg' | 'rgb' | 'rgba' | 'bgra';
+    /** Number of components (corresponds to channels string) */
+    components: 1 | 2 | 3 | 4;
+    /** What is the data type of each component */
+    dataType?: NormalizedDataType;
+    /** Number of bytes per pixel */
+    bytesPerPixel: number;
+    /** Number of bits per channel (may be unreliable for packed formats) */
+    bitsPerChannel: [number, number, number, number];
+    /** If this is a packed data type */
+    packed?: boolean;
+    /** SRGB texture format? */
+    srgb?: boolean;
+    /** WebGL specific texture format? */
+    webgl?: boolean;
+    /** Is this an integer or floating point format? */
+    integer: boolean;
+    /** Is this a signed or unsigned format? */
+    signed: boolean;
+    /** Is this a normalized integer format? */
+    normalized: boolean;
+    /** Is this a compressed texture format */
+    compressed?: boolean;
+    /** Compressed formats only: Block size for ASTC formats (texture width must be a multiple of this value) */
+    blockWidth?: number;
+    /** Compressed formats only: Block size for ASTC formats (texture height must be a multiple of this value) */
+    blockHeight?: number;
+};
+/**
+ * Texture format capabilities.
+ * @note Not directly usable. Can contain TextureFeature strings that need to be checked against a specific device.
+ */
+export type TextureFormatCapabilities = {
+    format: TextureFormat;
+    /** Can the format be created */
+    create: TextureFeature | boolean;
+    /** If a feature string, the specified device feature determines if format is renderable. */
+    render: TextureFeature | boolean;
+    /** If a feature string, the specified device feature determines if format is filterable. */
+    filter: TextureFeature | boolean;
+    /** If a feature string, the specified device feature determines if format is blendable. */
+    blend: TextureFeature | boolean;
+    /** If a feature string, the specified device feature determines if format is storeable. */
+    store: TextureFeature | boolean;
+};
+/**
+ * These represent the main compressed texture formats
+ * Each format typically has a number of more specific subformats
+ */
+export type TextureCompression = 'dxt' | 'dxt-srgb' | 'etc1' | 'etc2' | 'pvrtc' | 'atc' | 'astc' | 'rgtc';
+/**
+ * Texture feature checks
+ * @note these must be a subset of DeviceFeatures.
+ */
+export type TextureFeature = 'texture-compression-bc' | 'texture-compression-astc' | 'texture-compression-etc2' | 'texture-compression-etc1-webgl' | 'texture-compression-pvrtc-webgl' | 'texture-compression-atc-webgl' | 'float32-renderable-webgl' | 'float16-renderable-webgl' | 'rgb9e5ufloat-renderable-webgl' | 'snorm8-renderable-webgl' | 'norm16-renderable-webgl' | 'snorm16-renderable-webgl' | 'float32-filterable' | 'float16-filterable-webgl';
+/** Chrome-specific extensions. Expected to eventually become standard features. */
+export type ChromeExperimentalTextureFeature = 'chromium-experimental-unorm16-texture-formats' | 'chromium-experimental-snorm16-texture-formats';
+/** Texture formats */
+export type TextureFormat = TextureFormatColor | TextureFormatDepthStencil;
+/** Depth and stencil texture formats */
+export type TextureFormatDepthStencil = 'stencil8' | 'depth16unorm' | 'depth24plus' | 'depth24plus-stencil8' | 'depth32float' | 'depth32float-stencil8';
+/** Texture formats for color attachments */
+export type TextureFormatColor = TextureFormatColorUncompressed | TextureFormatCompressed;
+export type TextureFormatColorUncompressed = TextureFormatUnorm8 | TextureFormatSnorm8 | TextureFormatUint8 | TextureFormatSint8 | TextureFormatUnorm16 | TextureFormatSnorm16 | TextureFormatUint16 | TextureFormatSint16 | TextureFormatFloat16 | TextureFormatUint32 | TextureFormatSint32 | TextureFormatFloat32 | TextureFormatPacked16 | TextureFormatPacked32;
+type TextureFormatUnorm8 = 'r8unorm' | 'rg8unorm' | 'rgb8unorm-webgl' | 'rgba8unorm' | 'rgba8unorm-srgb' | 'bgra8unorm' | 'bgra8unorm-srgb';
+type TextureFormatSnorm8 = 'r8snorm' | 'rg8snorm' | 'rgb8snorm-webgl' | 'rgba8snorm';
+type TextureFormatUint8 = 'r8uint' | 'rg8uint' | 'rgba8uint';
+type TextureFormatSint8 = 'r8sint' | 'rg8sint' | 'rgba8sint';
+type TextureFormatUnorm16 = 'r16unorm' | 'rg16unorm' | 'rgb16unorm-webgl' | 'rgba16unorm';
+type TextureFormatSnorm16 = 'r16snorm' | 'rg16snorm' | 'rgb16snorm-webgl' | 'rgba16snorm';
+type TextureFormatUint16 = 'r16uint' | 'rg16uint' | 'rgba16uint';
+type TextureFormatSint16 = 'r16sint' | 'rg16sint' | 'rgba16sint';
+type TextureFormatFloat16 = 'r16float' | 'rg16float' | 'rgba16float';
+type TextureFormatUint32 = 'r32uint' | 'rg32uint' | 'rgba32uint';
+type TextureFormatSint32 = 'r32sint' | 'rg32sint' | 'rgba32sint';
+type TextureFormatFloat32 = 'r32float' | 'rg32float' | 'rgb32float-webgl' | 'rgba32float';
+type TextureFormatPacked16 = 'rgba4unorm-webgl' | 'rgb565unorm-webgl' | 'rgb5a1unorm-webgl';
+type TextureFormatPacked32 = 'rgb9e5ufloat' | 'rg11b10ufloat' | 'rgb10a2unorm' | 'rgb10a2uint';
+export type TextureFormatCompressed = 'bc1-rgb-unorm-webgl' | 'bc1-rgb-unorm-srgb-webgl' | 'pvrtc-rgb4unorm-webgl' | 'pvrtc-rgba4unorm-webgl' | 'pvrtc-rbg2unorm-webgl' | 'pvrtc-rgba2unorm-webgl' | 'etc1-rbg-unorm-webgl' | 'atc-rgb-unorm-webgl' | 'atc-rgba-unorm-webgl' | 'atc-rgbai-unorm-webgl' | 'bc1-rgba-unorm' | 'bc1-rgba-unorm-srgb' | 'bc2-rgba-unorm' | 'bc2-rgba-unorm-srgb' | 'bc3-rgba-unorm' | 'bc3-rgba-unorm-srgb' | 'bc4-r-unorm' | 'bc4-r-snorm' | 'bc5-rg-unorm' | 'bc5-rg-snorm' | 'bc6h-rgb-ufloat' | 'bc6h-rgb-float' | 'bc7-rgba-unorm' | 'bc7-rgba-unorm-srgb' | 'etc2-rgb8unorm' | 'etc2-rgb8unorm-srgb' | 'etc2-rgb8a1unorm' | 'etc2-rgb8a1unorm-srgb' | 'etc2-rgba8unorm' | 'etc2-rgba8unorm-srgb' | 'eac-r11unorm' | 'eac-r11snorm' | 'eac-rg11unorm' | 'eac-rg11snorm' | 'astc-4x4-unorm' | 'astc-4x4-unorm-srgb' | 'astc-5x4-unorm' | 'astc-5x4-unorm-srgb' | 'astc-5x5-unorm' | 'astc-5x5-unorm-srgb' | 'astc-6x5-unorm' | 'astc-6x5-unorm-srgb' | 'astc-6x6-unorm' | 'astc-6x6-unorm-srgb' | 'astc-8x5-unorm' | 'astc-8x5-unorm-srgb' | 'astc-8x6-unorm' | 'astc-8x6-unorm-srgb' | 'astc-8x8-unorm' | 'astc-8x8-unorm-srgb' | 'astc-10x5-unorm' | 'astc-10x5-unorm-srgb' | 'astc-10x6-unorm' | 'astc-10x6-unorm-srgb' | 'astc-10x8-unorm' | 'astc-10x8-unorm-srgb' | 'astc-10x10-unorm' | 'astc-10x10-unorm-srgb' | 'astc-12x10-unorm' | 'astc-12x10-unorm-srgb' | 'astc-12x12-unorm' | 'astc-12x12-unorm-srgb';
+export type TextureFormatDataType<T extends TextureFormat> = T extends TextureFormatUint8 ? 'uint8' : T extends TextureFormatSint8 ? 'sint8' : T extends TextureFormatUnorm8 ? 'unorm8' : T extends TextureFormatSnorm8 ? 'snorm8' : T extends TextureFormatUint16 ? 'uint16' : T extends TextureFormatSint16 ? 'sint16' : T extends TextureFormatUnorm16 ? 'unorm16' : T extends TextureFormatSnorm16 ? 'snorm16' : T extends TextureFormatUint32 ? 'uint32' : T extends TextureFormatSint32 ? 'sint32' : T extends TextureFormatFloat16 ? 'float16' : T extends TextureFormatFloat32 ? 'float32' : T extends TextureFormatDepthStencil ? 'uint32' : T extends TextureFormatCompressed ? 'uint8' : T extends TextureFormatPacked16 ? 'uint16' : T extends TextureFormatPacked32 ? 'uint32' : never;
+export {};
+//# sourceMappingURL=texture-formats.d.ts.map

package/dist/shadertypes/textures/texture-formats.d.ts.map

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

package/dist/shadertypes/textures/texture-formats.js

@@ -0,0 +1,58 @@
+// luma.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+export {};
+/*
+export type TextureFormatColorWebGPU =
+  // 8-bit formats
+  | 'r8unorm'
+  | 'r8snorm'
+  | 'r8uint'
+  | 'r8sint'
+  | 'rg8unorm'
+  | 'rg8snorm'
+  | 'rg8uint'
+  | 'rg8sint'
+  | 'rgba8unorm'
+  | 'rgba8unorm-srgb'
+  | 'rgba8snorm'
+  | 'rgba8uint'
+  | 'rgba8sint'
+  | 'bgra8unorm'
+  | 'bgra8unorm-srgb'
+
+  // 16-bit formats
+  | 'r16unorm' // feature: 'chromium-experimental-snorm16-texture-formats' chrome://flags/#enable-unsafe-webgpu 'r16unorm', 'rg16unorm', 'rgba16unorm',
+  | 'r16snorm' // feature: 'chromium-experimental-unorm16-texture-formats' chrome://flags/#enable-unsafe-webgpu 'r16snorm', 'rg16snorm',  'rgba16snorm'.
+  | 'r16uint'
+  | 'r16sint'
+  | 'r16float'
+  | 'rg16unorm' // feature: 'chromium-experimental-snorm16-texture-formats' chrome://flags/#enable-unsafe-webgpu 'r16unorm', 'rg16unorm', 'rgba16unorm',
+  | 'rg16snorm' // feature: 'chromium-experimental-unorm16-texture-formats' chrome://flags/#enable-unsafe-webgpu 'r16snorm', 'rg16snorm',  'rgba16snorm'.
+  | 'rgba16unorm' // feature: 'chromium-experimental-snorm16-texture-formats' chrome://flags/#enable-unsafe-webgpu 'r16unorm', 'rg16unorm', 'rgba16unorm',
+  | 'rgba16snorm' // feature: 'chromium-experimental-unorm16-texture-formats' chrome://flags/#enable-unsafe-webgpu 'r16snorm', 'rg16snorm',  'rgba16snorm'.
+  | 'rg16uint'
+  | 'rgba16uint'
+  | 'rg16sint'
+  | 'rgba16sint'
+  | 'rg16float'
+  | 'rgba16float'
+
+  // 32-bit formats
+  | 'r32uint'
+  | 'rg32uint'
+  | 'rgba32uint'
+  | 'r32sint'
+  | 'rg32sint'
+  | 'rgba32sint'
+  | 'r32float'
+  | 'rg32float'
+  | 'rgba32float'
+
+  // Packed 32-bit formats
+  | 'rgb9e5ufloat'
+  | 'rgb10a2unorm'
+  | 'rgb10a2uint'
+  | 'rg11b10ufloat';
+*/
+//# sourceMappingURL=texture-formats.js.map

package/dist/shadertypes/textures/texture-formats.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"texture-formats.js","sourceRoot":"","sources":["../../../src/shadertypes/textures/texture-formats.ts"],"names":[],"mappings":"AAAA,UAAU;AACV,+BAA+B;AAC/B,oCAAoC;;AAuRpC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAoDE"}

package/dist/shadertypes/{utils → vertex-arrays}/decode-vertex-format.d.ts

@@ -1,6 +1,6 @@
 import type { TypedArray } from "../../types.js";
-import type { PrimitiveDataType, SignedDataType } from "../data-types.js";
-import type { VertexFormat, VertexFormatInfo } from "../vertex-formats.js";
+import type { PrimitiveDataType, SignedDataType } from "../data-types/data-types.js";
+import type { VertexFormat, VertexFormatInfo } from "./vertex-formats.js";
 /**
  * Decodes a vertex format, returning type, components, byte  length and flags (integer, signed, normalized)
  */

package/dist/shadertypes/vertex-arrays/decode-vertex-format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decode-vertex-format.d.ts","sourceRoot":"","sources":["../../../src/shadertypes/vertex-arrays/decode-vertex-format.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAC,UAAU,EAAC,uBAAoB;AAC5C,OAAO,KAAK,EAAqB,iBAAiB,EAAE,cAAc,EAAC,oCAAiC;AACpG,OAAO,KAAK,EAAC,YAAY,EAAE,gBAAgB,EAAC,4BAAyB;AAGrE;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,YAAY,GAAG,gBAAgB,CAyB1E;AAED,oEAAoE;AACpE,wBAAgB,gBAAgB,CAC9B,cAAc,EAAE,cAAc,EAC9B,UAAU,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,EACzB,UAAU,CAAC,EAAE,OAAO,GACnB,YAAY,CAmCd;AAED,sEAAsE;AACtE,wBAAgB,4BAA4B,CAC1C,UAAU,EAAE,UAAU,EACtB,IAAI,EAAE,MAAM,EACZ,UAAU,CAAC,EAAE,OAAO,GACnB,YAAY,CAQd;AAED;4EAC4E;AAE5E,wBAAgB,yBAAyB,CAAC,IAAI,EAAE;IAC9C,aAAa,EAAE,iBAAiB,CAAC;IACjC,UAAU,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;CAC3B,GAAG,YAAY,CAqBf"}

package/dist/shadertypes/{utils → vertex-arrays}/decode-vertex-format.js

@@ -1,7 +1,7 @@
 // luma.gl
 // SPDX-License-Identifier: MIT
 // Copyright (c) vis.gl contributors
-import { getDataTypeInfo, getDataTypeFromTypedArray, makeNormalizedDataType } from "./decode-data-types.js";
+import { getDataTypeInfo, getDataType, getNormalizedDataType } from "../data-types/decode-data-types.js";
 /**
  * Decodes a vertex format, returning type, components, byte  length and flags (integer, signed, normalized)
  */
@@ -34,13 +34,13 @@ export function getVertexFormatInfo(format) {
 /** Build a vertex format from a signed data type and a component */
 export function makeVertexFormat(signedDataType, components, normalized) {
     const dataType = normalized
-        ? makeNormalizedDataType(signedDataType)
+        ? getNormalizedDataType(signedDataType)
         : signedDataType;
     switch (dataType) {
         // TODO - Special cases for WebGL (not supported on WebGPU), overrides the check below
         case 'unorm8':
             if (components === 1) {
-                return 'unorm8-webgl';
+                return 'unorm8';
             }
             if (components === 3) {
                 return 'unorm8x3-webgl';
@@ -71,7 +71,7 @@ export function getVertexFormatFromAttribute(typedArray, size, normalized) {
         throw new Error(`size ${size}`);
     }
     const components = size;
-    const signedDataType = getDataTypeFromTypedArray(typedArray);
+    const signedDataType = getDataType(typedArray);
     return makeVertexFormat(signedDataType, components, normalized);
 }
 /** Return a "default" vertex format for a certain shader data type

package/dist/shadertypes/vertex-arrays/decode-vertex-format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decode-vertex-format.js","sourceRoot":"","sources":["../../../src/shadertypes/vertex-arrays/decode-vertex-format.ts"],"names":[],"mappings":"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"}

package/dist/shadertypes/{vertex-formats.d.ts → vertex-arrays/vertex-formats.d.ts}

@@ -1,11 +1,11 @@
-import { NormalizedDataType } from "./data-types.js";
+import { NormalizedDataType } from "../data-types/data-types.js";
 /**
  * Describes the **memory format** and interpretation (normalization) of a buffer that will be supplied to vertex attributes
  * @note Must be compatible with the AttributeShaderType of the shaders, see documentation.
- * @note This is a superset of WebGPU vertex formats to allow foe some flexibility for WebGL only applications
+ * @note This is a superset of WebGPU vertex formats to allow for some flexibility for WebGL only applications
  * @todo Add device.isTextureFormatSupported() method?
  */
-export type VertexFormat = 'uint8x2' | 'uint8x4' | 'sint8x2' | 'sint8x4' | 'unorm8-webgl' | 'unorm8x2' | 'unorm8x3-webgl' | 'unorm8x4' | 'snorm8-webgl' | 'snorm8x2' | 'snorm8x3-webgl' | 'snorm8x4' | 'uint16x2' | 'uint16x4' | 'sint16x2' | 'sint16x4' | 'unorm16x2' | 'unorm16x4' | 'snorm16x2' | 'snorm16x4' | 'uint32' | 'uint32x2' | 'uint32x3' | 'uint32x4' | 'sint32' | 'sint32x2' | 'sint32x3' | 'sint32x4' | 'float16x2' | 'float16x4' | 'float32' | 'float32x2' | 'float32x3' | 'float32x4';
+export type VertexFormat = 'uint8' | 'uint8x2' | 'uint8x4' | 'sint8' | 'sint8x2' | 'sint8x4' | 'unorm8' | 'unorm8x2' | 'unorm8x3-webgl' | 'unorm8x4' | 'unorm8x4-bgra' | 'unorm10-10-10-2' | 'snorm8' | 'snorm8x2' | 'snorm8x3-webgl' | 'snorm8x4' | 'uint16' | 'sint16' | 'unorm16' | 'snorm16' | 'uint16x2' | 'uint16x4' | 'sint16x2' | 'sint16x4' | 'unorm16x2' | 'unorm16x4' | 'snorm16x2' | 'snorm16x4' | 'uint32' | 'uint32x2' | 'uint32x3' | 'uint32x4' | 'sint32' | 'sint32x2' | 'sint32x3' | 'sint32x4' | 'float16' | 'float16x2' | 'float16x4' | 'float32' | 'float32x2' | 'float32x3' | 'float32x4';
 export type VertexFormatInfo = {
     /** Type of each component */
     type: NormalizedDataType;
@@ -19,6 +19,8 @@ export type VertexFormatInfo = {
     signed: boolean;
     /** Is this a normalized format? */
     normalized: boolean;
+    /** Is this a bgra format? */
+    bgra?: boolean;
     /** Is this a webgl only format? */
     webglOnly?: boolean;
 };

package/dist/shadertypes/vertex-arrays/vertex-formats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vertex-formats.d.ts","sourceRoot":"","sources":["../../../src/shadertypes/vertex-arrays/vertex-formats.ts"],"names":[],"mappings":"AAIA,OAAO,EAAC,kBAAkB,EAAC,oCAAiC;AAI5D;;;;;GAKG;AACH,MAAM,MAAM,YAAY,GAEpB,OAAO,GACP,SAAS,GACT,SAAS,GACT,OAAO,GACP,SAAS,GACT,SAAS,GACT,QAAQ,GACR,UAAU,GACV,gBAAgB,GAChB,UAAU,GACV,eAAe,GACf,iBAAiB,GAEjB,QAAQ,GACR,UAAU,GACV,gBAAgB,GAChB,UAAU,GAEV,QAAQ,GACR,QAAQ,GACR,SAAS,GACT,SAAS,GACT,UAAU,GACV,UAAU,GACV,UAAU,GACV,UAAU,GACV,WAAW,GACX,WAAW,GACX,WAAW,GACX,WAAW,GAEX,QAAQ,GACR,UAAU,GACV,UAAU,GACV,UAAU,GACV,QAAQ,GACR,UAAU,GACV,UAAU,GACV,UAAU,GAWV,SAAS,GACT,WAAW,GACX,WAAW,GACX,SAAS,GACT,WAAW,GACX,WAAW,GACX,WAAW,CAAC;AAEhB,MAAM,MAAM,gBAAgB,GAAG;IAC7B,6BAA6B;IAC7B,IAAI,EAAE,kBAAkB,CAAC;IACzB,sBAAsB;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,4CAA4C;IAC5C,UAAU,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC1B,6EAA6E;IAC7E,OAAO,EAAE,OAAO,CAAC;IACjB,+BAA+B;IAC/B,MAAM,EAAE,OAAO,CAAC;IAChB,mCAAmC;IACnC,UAAU,EAAE,OAAO,CAAC;IACpB,6BAA6B;IAC7B,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,mCAAmC;IACnC,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB,CAAC"}

package/dist/shadertypes/vertex-arrays/vertex-formats.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vertex-formats.js","sourceRoot":"","sources":["../../../src/shadertypes/vertex-arrays/vertex-formats.ts"],"names":[],"mappings":"AAAA,UAAU;AACV,+BAA+B;AAC/B,oCAAoC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@luma.gl/core",
-  "version": "9.2.0-alpha.1",
+  "version": "9.2.0-alpha.5",
   "description": "The luma.gl core Device API",
   "license": "MIT",
   "type": "module",
@@ -46,5 +46,5 @@
     "@probe.gl/stats": "^4.0.8",
     "@types/offscreencanvas": "^2019.6.4"
   },
-  "gitHead": "d6d2f791f2ce96f4b5acb68e05faea62c35440fb"
+  "gitHead": "bf8346ab62619ec2c3e0b6dd54be3142328c6377"
 }

package/src/adapter/canvas-context.ts

@@ -5,7 +5,7 @@
 import {isBrowser} from '@probe.gl/env';
 import type {Device} from './device';
 import type {Framebuffer} from './resources/framebuffer';
-import type {DepthStencilTextureFormat} from '../shadertypes/texture-formats';
+import type {TextureFormatDepthStencil} from '../shadertypes/textures/texture-formats';
 import {uid} from '../utils/uid';
 import {withResolvers} from '../utils/promise-utils';
 
@@ -23,14 +23,16 @@ export type CanvasContextProps = {
   height?: number;
   /** Visibility (only used if new canvas is created). */
   visible?: boolean;
-  /** Whether to size the drawing buffer to the pixel size during auto resize */
-  useDevicePixels?: boolean;
-  /** Whether to track window resizes */
+  /** Whether to size the drawing buffer to the pixel size during auto resize. If a number is provided it is used as a static pixel ratio */
+  useDevicePixels?: boolean | number;
+  /** Whether to track window resizes. */
   autoResize?: boolean;
   /** @see https://developer.mozilla.org/en-US/docs/Web/API/GPUCanvasContext/configure#alphamode */
   alphaMode?: 'opaque' | 'premultiplied';
   /** @see https://developer.mozilla.org/en-US/docs/Web/API/GPUCanvasContext/configure#colorspace */
   colorSpace?: 'srgb'; // GPUPredefinedColorSpace
+  /** Whether to track position changes. Calls this.device.onPositionChange */
+  trackPosition?: boolean;
 };
 
 /**
@@ -59,7 +61,8 @@ export abstract class CanvasContext {
     container: null,
     visible: true,
     alphaMode: 'opaque',
-    colorSpace: 'srgb'
+    colorSpace: 'srgb',
+    trackPosition: false
   };
 
   abstract readonly device: Device;
@@ -101,6 +104,8 @@ export abstract class CanvasContext {
   protected _initializedResolvers = withResolvers<void>();
   protected readonly _resizeObserver: ResizeObserver | undefined;
   protected readonly _intersectionObserver: IntersectionObserver | undefined;
+  protected _position: [number, number];
+  protected destroyed = false;
 
   abstract get [Symbol.toStringTag](): string;
 
@@ -140,7 +145,7 @@ export abstract class CanvasContext {
       this.type = 'node';
     }
 
-    // Initialize size variables (these will be updated by ResizeObserver)
+    // Initialize size variables to some sane values (these will be updated by ResizeObserver)
     this.cssWidth = this.htmlCanvas?.clientWidth || this.canvas.width;
     this.cssHeight = this.htmlCanvas?.clientHeight || this.canvas.height;
     this.devicePixelWidth = this.canvas.width;
@@ -148,6 +153,7 @@ export abstract class CanvasContext {
     this.drawingBufferWidth = this.canvas.width;
     this.drawingBufferHeight = this.canvas.height;
     this.devicePixelRatio = globalThis.devicePixelRatio || 1;
+    this._position = [0, 0];
 
     if (CanvasContext.isHTMLCanvas(this.canvas)) {
       // Track visibility changes
@@ -168,12 +174,21 @@ export abstract class CanvasContext {
       // Track device pixel ratio changes.
       // Defer call to after construction completes to ensure `this.device` is available.
       setTimeout(() => this._observeDevicePixelRatio(), 0);
+
+      // Track top/left position changes
+      if (this.props.trackPosition) {
+        this._trackPosition();
+      }
     }
   }
 
+  destroy() {
+    this.destroyed = true;
+  }
+
   /** Returns a framebuffer with properly resized current 'swap chain' textures */
   abstract getCurrentFramebuffer(options?: {
-    depthStencilFormat?: DepthStencilTextureFormat | false;
+    depthStencilFormat?: TextureFormatDepthStencil | false;
   }): Framebuffer;
 
   // SIZE METHODS
@@ -187,6 +202,10 @@ export abstract class CanvasContext {
     return [this.cssWidth, this.cssHeight];
   }
 
+  getPosition() {
+    return this._position;
+  }
+
   /**
    * Returns the size covered by the canvas in actual device pixels.
    * @note This can be different from the 'CSS' size of a canvas due to DPR scaling, and rounding to integer pixels
@@ -343,7 +362,10 @@ export abstract class CanvasContext {
 
     // Update the canvas drawing buffer size
     if (this.props.autoResize) {
-      if (this.props.useDevicePixels) {
+      if (typeof this.props.useDevicePixels === 'number') {
+        const dpr = this.props.useDevicePixels;
+        this.setDrawingBufferSize(this.cssWidth * dpr, this.cssHeight * dpr);
+      } else if (this.props.useDevicePixels) {
         this.setDrawingBufferSize(this.devicePixelWidth, this.devicePixelHeight);
       } else {
         this.setDrawingBufferSize(this.cssWidth, this.cssHeight);
@@ -357,6 +379,8 @@ export abstract class CanvasContext {
     this._initializedResolvers.resolve();
     this.isInitialized = true;
 
+    this.updatePosition();
+
     // Inform the device
     this.device.props.onResize(this, {oldPixelSize});
   }
@@ -366,6 +390,8 @@ export abstract class CanvasContext {
     const oldRatio = this.devicePixelRatio;
     this.devicePixelRatio = window.devicePixelRatio;
 
+    this.updatePosition();
+
     // Inform the device
     this.device.props.onDevicePixelRatioChange(this, {oldRatio});
     // Set up a one time query against the current resolution.
@@ -375,6 +401,38 @@ export abstract class CanvasContext {
       {once: true}
     );
   }
+
+  /** Start tracking positions with a timer */
+  _trackPosition(intervalMs: number = 100): void {
+    const intervalId = setInterval(() => {
+      if (this.destroyed) {
+        clearInterval(intervalId);
+      } else {
+        this.updatePosition();
+      }
+    }, intervalMs);
+  }
+
+  /**
+   * Calculated the absolute position of the canvas
+   * @note - getBoundingClientRect() is normally cheap but can be expensive
+   * if called before browser has finished a reflow. Should not be the case here.
+   */
+  updatePosition() {
+    const newRect = this.htmlCanvas?.getBoundingClientRect();
+    if (newRect) {
+      // We only track position since we rely on the more precise ResizeObserver for size
+      const position: [number, number] = [newRect.left, newRect.top];
+      this._position ??= position;
+      const positionChanged =
+        position[0] !== this._position[0] || position[1] !== this._position[1];
+      if (positionChanged) {
+        const oldPosition = this._position;
+        this._position = position;
+        this.device.props.onPositionChange?.(this, {oldPosition});
+      }
+    }
+  }
 }
 
 // HELPER FUNCTIONS