@carbonenginejs/runtime 0.1.0-alpha.4 → 0.1.0-alpha.5

package/dist/trinityal/stub/Tr2SwapChainALStub.js.map

@@ -1 +1 @@
-{"version":3,"file":"Tr2SwapChainALStub.js","sources":["../../../../src/trinityal/stub/Tr2SwapChainALStub.js"],"sourcesContent":["// Source: trinity/trinityal/stub/Tr2SwapChainALStub.cpp\r\n// Source: trinity/trinityal/stub/Tr2SwapChainALStub.h\r\n//\r\n// A swap chain with no window behind it.\r\n//\r\n// It owns one back buffer, and `IsValid` is that back buffer's validity - so a\r\n// swap chain that failed to allocate reports itself unusable rather than\r\n// presenting into nothing.\r\n//\r\n// CARBON'S BACK BUFFER HERE IS 4x4, and that is not a placeholder someone\r\n// forgot: the stub has no window to ask for a size, and a caller that needs a\r\n// real size uses the render context's default back buffer, which is created\r\n// from the present parameters. Transcribed as it stands, because inventing a\r\n// size would make a headless test agree with a number nothing chose.\r\n\r\nimport { CjsSchema } from \"#schema\";\r\nimport { Tr2ALMemoryType, Tr2DeviceResourceAL } from \"../Tr2DeviceResourceAL/index.js\";\r\nimport { ALResult } from \"../ALResult.js\";\r\nimport { Tr2BitmapDimensions } from \"../Tr2BitmapDimensions.js\";\r\nimport { Tr2TextureALStub } from \"./Tr2TextureALStub.js\";\r\nimport { PixelFormat, Tr2GpuUsage } from \"../../global/consts/renderContext/index.js\";\r\n\r\n\r\n/** Carbon's stub back-buffer size (`Tr2SwapChainALStub.cpp:27`). */\r\nconst STUB_BACK_BUFFER_SIZE = 4;\r\n\r\n\r\n/**\r\n * A swap chain whose presents complete immediately.\r\n */\r\nexport class Tr2SwapChainALStub extends Tr2DeviceResourceAL\r\n{\r\n  /** m_backBuffer */\r\n  _backBuffer = new Tr2TextureALStub();\r\n\r\n  /**\r\n   * Creates the swap chain and its back buffer.\r\n   *\r\n   * @param {object} windowHandle The window to present into; ignored here.\r\n   * @param {object} renderContext The context to create against.\r\n   * @returns {number} An `ALResult` value.\r\n   */\r\n  Create(windowHandle, renderContext)\r\n  {\r\n    if (!renderContext.IsValid()) return ALResult.E_INVALIDARG;\r\n\r\n    this._backBuffer.Destroy();\r\n    this._backBuffer = new Tr2TextureALStub();\r\n\r\n    return this._backBuffer.Create(\r\n      Tr2BitmapDimensions.Texture2D(\r\n        STUB_BACK_BUFFER_SIZE,\r\n        STUB_BACK_BUFFER_SIZE,\r\n        1,\r\n        PixelFormat.PIXEL_FORMAT_B8G8R8X8_UNORM\r\n      ),\r\n      { gpuUsage: Tr2GpuUsage.RENDER_TARGET },\r\n      renderContext\r\n    );\r\n  }\r\n\r\n  /** Releases the back buffer and leaves the device-resource registry. */\r\n  Destroy()\r\n  {\r\n    this._backBuffer.Destroy();\r\n    this._backBuffer = new Tr2TextureALStub();\r\n    super.Destroy();\r\n  }\r\n\r\n  /**\r\n   * Whether the chain can be presented.\r\n   *\r\n   * @returns {boolean} The back buffer's validity.\r\n   */\r\n  IsValid()\r\n  {\r\n    return this._backBuffer.IsValid();\r\n  }\r\n\r\n  /**\r\n   * The back buffer.\r\n   *\r\n   * @returns {Tr2TextureALStub} The texture.\r\n   */\r\n  GetBackBuffer()\r\n  {\r\n    return this._backBuffer;\r\n  }\r\n\r\n  /**\r\n   * Presents the back buffer. There is nothing to show, but the frame ended.\r\n   *\r\n   * @param {object} _renderContext The context presenting the frame; Carbon\r\n   *   takes it (`Tr2SwapChainALStub.cpp:41`) and names no parameter, because\r\n   *   the stub has nothing to present into.\r\n   * @returns {number} An `ALResult` value.\r\n   */\r\n  Present(_renderContext)\r\n  {\r\n    return ALResult.S_OK;\r\n  }\r\n\r\n  /**\r\n   * Back buffer width.\r\n   *\r\n   * @returns {number} Width in pixels.\r\n   */\r\n  GetWidth()\r\n  {\r\n    return this._backBuffer.GetWidth();\r\n  }\r\n\r\n  /**\r\n   * Back buffer height.\r\n   *\r\n   * @returns {number} Height in pixels.\r\n   */\r\n  GetHeight()\r\n  {\r\n    return this._backBuffer.GetHeight();\r\n  }\r\n\r\n  /**\r\n   * Which memory class this chain occupies.\r\n   *\r\n   * VIDEO, not managed - the one AL resource that says so, because a swap\r\n   * chain's surfaces belong to the display rather than to the device heap.\r\n   *\r\n   * @returns {number} A `Tr2ALMemoryType` value.\r\n   */\r\n  GetMemoryClass()\r\n  {\r\n    return Tr2ALMemoryType.AL_MEMORY_VIDEO;\r\n  }\r\n\r\n  /**\r\n   * Names the chain for a debugger.\r\n   *\r\n   * @param {string} _name The name Carbon would attach; the stub discards it.\r\n   * @returns {number} An `ALResult` value; the stub keeps no name.\r\n   */\r\n  SetName(_name)\r\n  {\r\n    return ALResult.S_OK;\r\n  }\r\n}\r\n\r\n// DECLARED AS A CALL, NOT A DECORATOR, for the reason recorded in\r\n// Tr2BitmapDimensions.js: the layer is imported straight from source by its\r\n// tests and raw Node cannot parse decorator syntax.\r\n//\r\n// The donor is NAMED rather than left to be derived from this class's name.\r\n// Carbon calls every backend's class the same thing and carries the backend in\r\n// the FILE name, because only one backend compiles at a time; we ship them\r\n// together, so the backend moves onto the class name. That divergence is the\r\n// author's to declare, never a checker's to guess.\r\nCjsSchema.define(Tr2SwapChainALStub, { className: \"Tr2SwapChainALStub\", carbon: \"Tr2SwapChainAL\" });\r\n"],"names":["STUB_BACK_BUFFER_SIZE","Tr2SwapChainALStub","Tr2DeviceResourceAL","_backBuffer","Tr2TextureALStub","Create","windowHandle","renderContext","IsValid","ALResult","E_INVALIDARG","Destroy","Tr2BitmapDimensions","Texture2D","PixelFormat","PIXEL_FORMAT_B8G8R8X8_UNORM","gpuUsage","Tr2GpuUsage","RENDER_TARGET","GetBackBuffer","Present","_renderContext","S_OK","GetWidth","GetHeight","GetMemoryClass","Tr2ALMemoryType","AL_MEMORY_VIDEO","SetName","_name","CjsSchema","define","className","carbon"],"mappings":";;;;;;;;;;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;;AAUA;AACA,MAAMA,qBAAqB,GAAG,CAAC;;AAG/B;AACA;AACA;AACO,MAAMC,kBAAkB,SAASC,mBAAmB,CAC3D;AACE;AACAC,EAAAA,WAAW,GAAG,IAAIC,gBAAgB,EAAE;;AAEpC;AACF;AACA;AACA;AACA;AACA;AACA;AACEC,EAAAA,MAAMA,CAACC,YAAY,EAAEC,aAAa,EAClC;IACE,IAAI,CAACA,aAAa,CAACC,OAAO,EAAE,EAAE,OAAOC,QAAQ,CAACC,YAAY;AAE1D,IAAA,IAAI,CAACP,WAAW,CAACQ,OAAO,EAAE;AAC1B,IAAA,IAAI,CAACR,WAAW,GAAG,IAAIC,gBAAgB,EAAE;IAEzC,OAAO,IAAI,CAACD,WAAW,CAACE,MAAM,CAC5BO,mBAAmB,CAACC,SAAS,CAC3Bb,qBAAqB,EACrBA,qBAAqB,EACrB,CAAC,EACDc,WAAW,CAACC,2BACd,CAAC,EACD;MAAEC,QAAQ,EAAEC,WAAW,CAACC;KAAe,EACvCX,aACF,CAAC;AACH,EAAA;;AAEA;AACAI,EAAAA,OAAOA,GACP;AACE,IAAA,IAAI,CAACR,WAAW,CAACQ,OAAO,EAAE;AAC1B,IAAA,IAAI,CAACR,WAAW,GAAG,IAAIC,gBAAgB,EAAE;IACzC,KAAK,CAACO,OAAO,EAAE;AACjB,EAAA;;AAEA;AACF;AACA;AACA;AACA;AACEH,EAAAA,OAAOA,GACP;AACE,IAAA,OAAO,IAAI,CAACL,WAAW,CAACK,OAAO,EAAE;AACnC,EAAA;;AAEA;AACF;AACA;AACA;AACA;AACEW,EAAAA,aAAaA,GACb;IACE,OAAO,IAAI,CAAChB,WAAW;AACzB,EAAA;;AAEA;AACF;AACA;AACA;AACA;AACA;AACA;AACA;EACEiB,OAAOA,CAACC,cAAc,EACtB;IACE,OAAOZ,QAAQ,CAACa,IAAI;AACtB,EAAA;;AAEA;AACF;AACA;AACA;AACA;AACEC,EAAAA,QAAQA,GACR;AACE,IAAA,OAAO,IAAI,CAACpB,WAAW,CAACoB,QAAQ,EAAE;AACpC,EAAA;;AAEA;AACF;AACA;AACA;AACA;AACEC,EAAAA,SAASA,GACT;AACE,IAAA,OAAO,IAAI,CAACrB,WAAW,CAACqB,SAAS,EAAE;AACrC,EAAA;;AAEA;AACF;AACA;AACA;AACA;AACA;AACA;AACA;AACEC,EAAAA,cAAcA,GACd;IACE,OAAOC,eAAe,CAACC,eAAe;AACxC,EAAA;;AAEA;AACF;AACA;AACA;AACA;AACA;EACEC,OAAOA,CAACC,KAAK,EACb;IACE,OAAOpB,QAAQ,CAACa,IAAI;AACtB,EAAA;AACF;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACAQ,SAAS,CAACC,MAAM,CAAC9B,kBAAkB,EAAE;AAAE+B,EAAAA,SAAS,EAAE,oBAAoB;AAAEC,EAAAA,MAAM,EAAE;AAAiB,CAAC,CAAC;;;;"}
+{"version":3,"file":"Tr2SwapChainALStub.js","sources":["../../../../src/trinityal/stub/Tr2SwapChainALStub.js"],"sourcesContent":["// Source: trinity/trinityal/stub/Tr2SwapChainALStub.cpp\n// Source: trinity/trinityal/stub/Tr2SwapChainALStub.h\n//\n// A swap chain with no window behind it.\n//\n// It owns one back buffer, and `IsValid` is that back buffer's validity - so a\n// swap chain that failed to allocate reports itself unusable rather than\n// presenting into nothing.\n//\n// CARBON'S BACK BUFFER HERE IS 4x4, and that is not a placeholder someone\n// forgot: the stub has no window to ask for a size, and a caller that needs a\n// real size uses the render context's default back buffer, which is created\n// from the present parameters. Transcribed as it stands, because inventing a\n// size would make a headless test agree with a number nothing chose.\n\nimport { CjsSchema } from \"#schema\";\nimport { Tr2ALMemoryType, Tr2DeviceResourceAL } from \"../Tr2DeviceResourceAL/index.js\";\nimport { ALResult } from \"../ALResult.js\";\nimport { BitmapDimensions as Tr2BitmapDimensions } from \"#imageio\";\nimport { Tr2TextureALStub } from \"./Tr2TextureALStub.js\";\nimport { PixelFormat, Tr2GpuUsage } from \"../../global/consts/renderContext/index.js\";\n\n\n/** Carbon's stub back-buffer size (`Tr2SwapChainALStub.cpp:27`). */\nconst STUB_BACK_BUFFER_SIZE = 4;\n\n\n/**\n * A swap chain whose presents complete immediately.\n */\nexport class Tr2SwapChainALStub extends Tr2DeviceResourceAL\n{\n  /** m_backBuffer */\n  _backBuffer = new Tr2TextureALStub();\n\n  /**\n   * Creates the swap chain and its back buffer.\n   *\n   * @param {object} windowHandle The window to present into; ignored here.\n   * @param {object} renderContext The context to create against.\n   * @returns {number} An `ALResult` value.\n   */\n  Create(windowHandle, renderContext)\n  {\n    if (!renderContext.IsValid()) return ALResult.E_INVALIDARG;\n\n    this._backBuffer.Destroy();\n    this._backBuffer = new Tr2TextureALStub();\n\n    return this._backBuffer.Create(\n      Tr2BitmapDimensions.texture2D(\n        STUB_BACK_BUFFER_SIZE,\n        STUB_BACK_BUFFER_SIZE,\n        1,\n        PixelFormat.PIXEL_FORMAT_B8G8R8X8_UNORM\n      ),\n      { gpuUsage: Tr2GpuUsage.RENDER_TARGET },\n      renderContext\n    );\n  }\n\n  /** Releases the back buffer and leaves the device-resource registry. */\n  Destroy()\n  {\n    this._backBuffer.Destroy();\n    this._backBuffer = new Tr2TextureALStub();\n    super.Destroy();\n  }\n\n  /**\n   * Whether the chain can be presented.\n   *\n   * @returns {boolean} The back buffer's validity.\n   */\n  IsValid()\n  {\n    return this._backBuffer.IsValid();\n  }\n\n  /**\n   * The back buffer.\n   *\n   * @returns {Tr2TextureALStub} The texture.\n   */\n  GetBackBuffer()\n  {\n    return this._backBuffer;\n  }\n\n  /**\n   * Presents the back buffer. There is nothing to show, but the frame ended.\n   *\n   * @param {object} _renderContext The context presenting the frame; Carbon\n   *   takes it (`Tr2SwapChainALStub.cpp:41`) and names no parameter, because\n   *   the stub has nothing to present into.\n   * @returns {number} An `ALResult` value.\n   */\n  Present(_renderContext)\n  {\n    return ALResult.S_OK;\n  }\n\n  /**\n   * Back buffer width.\n   *\n   * @returns {number} Width in pixels.\n   */\n  GetWidth()\n  {\n    return this._backBuffer.GetWidth();\n  }\n\n  /**\n   * Back buffer height.\n   *\n   * @returns {number} Height in pixels.\n   */\n  GetHeight()\n  {\n    return this._backBuffer.GetHeight();\n  }\n\n  /**\n   * Which memory class this chain occupies.\n   *\n   * VIDEO, not managed - the one AL resource that says so, because a swap\n   * chain's surfaces belong to the display rather than to the device heap.\n   *\n   * @returns {number} A `Tr2ALMemoryType` value.\n   */\n  GetMemoryClass()\n  {\n    return Tr2ALMemoryType.AL_MEMORY_VIDEO;\n  }\n\n  /**\n   * Names the chain for a debugger.\n   *\n   * @param {string} _name The name Carbon would attach; the stub discards it.\n   * @returns {number} An `ALResult` value; the stub keeps no name.\n   */\n  SetName(_name)\n  {\n    return ALResult.S_OK;\n  }\n}\n\n// DECLARED AS A CALL, NOT A DECORATOR, for the reason recorded in\n// Tr2BitmapDimensions.js: the layer is imported straight from source by its\n// tests and raw Node cannot parse decorator syntax.\n//\n// The donor is NAMED rather than left to be derived from this class's name.\n// Carbon calls every backend's class the same thing and carries the backend in\n// the FILE name, because only one backend compiles at a time; we ship them\n// together, so the backend moves onto the class name. That divergence is the\n// author's to declare, never a checker's to guess.\nCjsSchema.define(Tr2SwapChainALStub, { className: \"Tr2SwapChainALStub\", carbon: \"Tr2SwapChainAL\" });\n"],"names":["STUB_BACK_BUFFER_SIZE","Tr2SwapChainALStub","Tr2DeviceResourceAL","_backBuffer","Tr2TextureALStub","Create","windowHandle","renderContext","IsValid","ALResult","E_INVALIDARG","Destroy","Tr2BitmapDimensions","texture2D","PixelFormat","PIXEL_FORMAT_B8G8R8X8_UNORM","gpuUsage","Tr2GpuUsage","RENDER_TARGET","GetBackBuffer","Present","_renderContext","S_OK","GetWidth","GetHeight","GetMemoryClass","Tr2ALMemoryType","AL_MEMORY_VIDEO","SetName","_name","CjsSchema","define","className","carbon"],"mappings":";;;;;;;;;;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;;AAUA;AACA,MAAMA,qBAAqB,GAAG,CAAC;;AAG/B;AACA;AACA;AACO,MAAMC,kBAAkB,SAASC,mBAAmB,CAC3D;AACE;AACAC,EAAAA,WAAW,GAAG,IAAIC,gBAAgB,EAAE;;AAEpC;AACF;AACA;AACA;AACA;AACA;AACA;AACEC,EAAAA,MAAMA,CAACC,YAAY,EAAEC,aAAa,EAClC;IACE,IAAI,CAACA,aAAa,CAACC,OAAO,EAAE,EAAE,OAAOC,QAAQ,CAACC,YAAY;AAE1D,IAAA,IAAI,CAACP,WAAW,CAACQ,OAAO,EAAE;AAC1B,IAAA,IAAI,CAACR,WAAW,GAAG,IAAIC,gBAAgB,EAAE;IAEzC,OAAO,IAAI,CAACD,WAAW,CAACE,MAAM,CAC5BO,gBAAmB,CAACC,SAAS,CAC3Bb,qBAAqB,EACrBA,qBAAqB,EACrB,CAAC,EACDc,WAAW,CAACC,2BACd,CAAC,EACD;MAAEC,QAAQ,EAAEC,WAAW,CAACC;KAAe,EACvCX,aACF,CAAC;AACH,EAAA;;AAEA;AACAI,EAAAA,OAAOA,GACP;AACE,IAAA,IAAI,CAACR,WAAW,CAACQ,OAAO,EAAE;AAC1B,IAAA,IAAI,CAACR,WAAW,GAAG,IAAIC,gBAAgB,EAAE;IACzC,KAAK,CAACO,OAAO,EAAE;AACjB,EAAA;;AAEA;AACF;AACA;AACA;AACA;AACEH,EAAAA,OAAOA,GACP;AACE,IAAA,OAAO,IAAI,CAACL,WAAW,CAACK,OAAO,EAAE;AACnC,EAAA;;AAEA;AACF;AACA;AACA;AACA;AACEW,EAAAA,aAAaA,GACb;IACE,OAAO,IAAI,CAAChB,WAAW;AACzB,EAAA;;AAEA;AACF;AACA;AACA;AACA;AACA;AACA;AACA;EACEiB,OAAOA,CAACC,cAAc,EACtB;IACE,OAAOZ,QAAQ,CAACa,IAAI;AACtB,EAAA;;AAEA;AACF;AACA;AACA;AACA;AACEC,EAAAA,QAAQA,GACR;AACE,IAAA,OAAO,IAAI,CAACpB,WAAW,CAACoB,QAAQ,EAAE;AACpC,EAAA;;AAEA;AACF;AACA;AACA;AACA;AACEC,EAAAA,SAASA,GACT;AACE,IAAA,OAAO,IAAI,CAACrB,WAAW,CAACqB,SAAS,EAAE;AACrC,EAAA;;AAEA;AACF;AACA;AACA;AACA;AACA;AACA;AACA;AACEC,EAAAA,cAAcA,GACd;IACE,OAAOC,eAAe,CAACC,eAAe;AACxC,EAAA;;AAEA;AACF;AACA;AACA;AACA;AACA;EACEC,OAAOA,CAACC,KAAK,EACb;IACE,OAAOpB,QAAQ,CAACa,IAAI;AACtB,EAAA;AACF;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACAQ,SAAS,CAACC,MAAM,CAAC9B,kBAAkB,EAAE;AAAE+B,EAAAA,SAAS,EAAE,oBAAoB;AAAEC,EAAAA,MAAM,EAAE;AAAiB,CAAC,CAAC;;;;"}

package/dist/trinityal/stub/Tr2TextureALStub.js

@@ -2,7 +2,7 @@ import { CjsSchema } from '#schema';
 import { Tr2ALMemoryType } from '../Tr2DeviceResourceAL/Tr2BaseDeviceResourceAL.js';
 import { Tr2DeviceResourceAL } from '../Tr2DeviceResourceAL/Tr2DeviceResourceAL.js';
 import { ALResult } from '../ALResult.js';
-import { Tr2BitmapDimensions } from '../Tr2BitmapDimensions.js';
+import { BitmapDimensions } from '#imageio';
 import { Crop, Tr2TextureSubresource } from '../Tr2HalHelperStructures/Tr2TextureSubresource.js';
 import { TextureType, IsCompressedFormat } from '../../global/consts/renderContext/formats.js';
 import '../../global/consts/renderContext/pipeline.js';
@@ -49,12 +49,12 @@ import { Tr2MsaaDesc } from '../Tr2HalHelperStructures/Tr2MsaaDesc.js';
 /** Carbon's "no descriptor heap index", returned by both heap accessors. */
 const NO_HEAP_INDEX = 0xffffffff;
 
-/**
- * A texture that validates like a real one and holds its pixels on the CPU.
+/**
+ * A texture that validates like a real one and holds its pixels on the CPU.
  */
 class Tr2TextureALStub extends Tr2DeviceResourceAL {
   /** m_desc */
-  _desc = new Tr2BitmapDimensions();
+  _desc = new BitmapDimensions();
 
   /** m_msaa */
   _msaa = new Tr2MsaaDesc();
@@ -68,20 +68,20 @@ class Tr2TextureALStub extends Tr2DeviceResourceAL {
   /** m_data - allocated on first map, released on unmap unless kept "often". */
   _data = null;
 
-  /**
-   * Creates the texture.
-   *
-   * Every refusal below is Carbon's, in Carbon's order
-   * (`Tr2TextureALStub.cpp:18-95`).
-   *
-   * @param {Tr2BitmapDimensions} desc The texture description.
-   * @param {object} options Creation options.
-   * @param {number} [options.gpuUsage] A `Tr2GpuUsage` bit set.
-   * @param {number} [options.cpuUsage] A `Tr2CpuUsage` bit set.
-   * @param {Tr2MsaaDesc} [options.msaa] Multisample description.
-   * @param {object[]} [options.initialData] Initial subresource data, if any.
-   * @param {object} renderContext The context to create against.
-   * @returns {number} An `ALResult` value.
+  /**
+   * Creates the texture.
+   *
+   * Every refusal below is Carbon's, in Carbon's order
+   * (`Tr2TextureALStub.cpp:18-95`).
+   *
+   * @param {Tr2BitmapDimensions} desc The texture description.
+   * @param {object} options Creation options.
+   * @param {number} [options.gpuUsage] A `Tr2GpuUsage` bit set.
+   * @param {number} [options.cpuUsage] A `Tr2CpuUsage` bit set.
+   * @param {Tr2MsaaDesc} [options.msaa] Multisample description.
+   * @param {object[]} [options.initialData] Initial subresource data, if any.
+   * @param {object} renderContext The context to create against.
+   * @returns {number} An `ALResult` value.
    */
   Create(desc, options, renderContext) {
     this._Reset();
@@ -142,12 +142,12 @@ class Tr2TextureALStub extends Tr2DeviceResourceAL {
     return ALResult.S_OK;
   }
 
-  /**
-   * Adopts a texture shared by another device.
-   *
-   * Carbon's stub refuses: sharing needs a real device on both sides.
-   *
-   * @returns {number} An `ALResult` value.
+  /**
+   * Adopts a texture shared by another device.
+   *
+   * Carbon's stub refuses: sharing needs a real device on both sides.
+   *
+   * @returns {number} An `ALResult` value.
    */
   OpenShared() {
     return ALResult.E_FAIL;
@@ -155,7 +155,7 @@ class Tr2TextureALStub extends Tr2DeviceResourceAL {
 
   /** Carbon's impl `Destroy`: clears the description without unregistering. */
   _Reset() {
-    this._desc = new Tr2BitmapDimensions();
+    this._desc = new BitmapDimensions();
     this._msaa = new Tr2MsaaDesc();
     this._gpuUsage = Tr2GpuUsage.NONE;
     this._cpuUsage = Tr2CpuUsage.NONE;
@@ -168,155 +168,155 @@ class Tr2TextureALStub extends Tr2DeviceResourceAL {
     super.Destroy();
   }
 
-  /**
-   * Whether the texture holds anything.
-   *
-   * Carbon's test is the width, because a created texture always has one.
-   *
-   * @returns {boolean} True when created.
+  /**
+   * Whether the texture holds anything.
+   *
+   * Carbon's test is the width, because a created texture always has one.
+   *
+   * @returns {boolean} True when created.
    */
   IsValid() {
     return this._desc.GetWidth() !== 0;
   }
 
-  /**
-   * Which memory class this texture occupies.
-   *
-   * @returns {number} A `Tr2ALMemoryType` value.
+  /**
+   * Which memory class this texture occupies.
+   *
+   * @returns {number} A `Tr2ALMemoryType` value.
    */
   GetMemoryClass() {
     return Tr2ALMemoryType.AL_MEMORY_MANAGED;
   }
 
-  /**
-   * The texture description.
-   *
-   * @returns {Tr2BitmapDimensions} The description.
+  /**
+   * The texture description.
+   *
+   * @returns {Tr2BitmapDimensions} The description.
    */
   GetDesc() {
     return this._desc;
   }
 
-  /**
-   * The multisample description.
-   *
-   * @returns {Tr2MsaaDesc} The description.
+  /**
+   * The multisample description.
+   *
+   * @returns {Tr2MsaaDesc} The description.
    */
   GetMsaaDesc() {
     return this._msaa;
   }
 
-  /**
-   * The GPU usage this texture was created with.
-   *
-   * @returns {number} A `Tr2GpuUsage` bit set.
+  /**
+   * The GPU usage this texture was created with.
+   *
+   * @returns {number} A `Tr2GpuUsage` bit set.
    */
   GetGpuUsage() {
     return this._gpuUsage;
   }
 
-  /**
-   * The CPU usage this texture was created with.
-   *
-   * @returns {number} A `Tr2CpuUsage` bit set.
+  /**
+   * The CPU usage this texture was created with.
+   *
+   * @returns {number} A `Tr2CpuUsage` bit set.
    */
   GetCpuUsage() {
     return this._cpuUsage;
   }
 
-  /**
-   * Width of mip zero.
-   *
-   * @returns {number} Width in pixels.
+  /**
+   * Width of mip zero.
+   *
+   * @returns {number} Width in pixels.
    */
   GetWidth() {
     return this._desc.GetWidth();
   }
 
-  /**
-   * Height of mip zero.
-   *
-   * @returns {number} Height in pixels.
+  /**
+   * Height of mip zero.
+   *
+   * @returns {number} Height in pixels.
    */
   GetHeight() {
     return this._desc.GetHeight();
   }
 
-  /**
-   * Volume depth.
-   *
-   * @returns {number} Depth in slices.
+  /**
+   * Volume depth.
+   *
+   * @returns {number} Depth in slices.
    */
   GetDepth() {
     return this._desc.GetDepth();
   }
 
-  /**
-   * The declared mip count.
-   *
-   * @returns {number} Mip levels as declared.
+  /**
+   * The declared mip count.
+   *
+   * @returns {number} Mip levels as declared.
    */
   GetMipCount() {
     return this._desc.GetMipCount();
   }
 
-  /**
-   * The mip count in effect.
-   *
-   * @returns {number} Mip levels.
+  /**
+   * The mip count in effect.
+   *
+   * @returns {number} Mip levels.
    */
   GetTrueMipCount() {
     return this._desc.GetTrueMipCount();
   }
 
-  /**
-   * The pixel format.
-   *
-   * @returns {number} A `PixelFormat` value.
+  /**
+   * The pixel format.
+   *
+   * @returns {number} A `PixelFormat` value.
    */
   GetFormat() {
     return this._desc.GetFormat();
   }
 
-  /**
-   * The texture type.
-   *
-   * @returns {number} A `TextureType` value.
+  /**
+   * The texture type.
+   *
+   * @returns {number} A `TextureType` value.
    */
   GetType() {
     return this._desc.GetType();
   }
 
-  /**
-   * Slices in the array.
-   *
-   * @returns {number} Array size.
+  /**
+   * Slices in the array.
+   *
+   * @returns {number} Array size.
    */
   GetArraySize() {
     return this._desc.GetArraySize();
   }
 
-  /**
-   * Bytes in one mip.
-   *
-   * @param {number} mip Mip level.
-   * @returns {number} Size in bytes.
+  /**
+   * Bytes in one mip.
+   *
+   * @param {number} mip Mip level.
+   * @returns {number} Size in bytes.
    */
   GetMipSize(mip) {
     return this._desc.GetMipSize(mip);
   }
 
-  /**
-   * Allocates and returns the storage for one subresource, for reading.
-   *
-   * The CPU-read check comes FIRST, before validity, because a texture that
-   * was never created for reading is a caller mistake rather than a state
-   * problem - which is why it answers `E_INVALIDCALL` and not `E_FAIL`.
-   *
-   * @param {Tr2TextureSubresource} region The subresource to map.
-   * @param {boolean} synchronize Whether to wait for outstanding GPU work.
-   * @param {object} renderContext The context to map against.
-   * @returns {{result: number, data: Uint8Array|null, pitch: number}} The mapping.
+  /**
+   * Allocates and returns the storage for one subresource, for reading.
+   *
+   * The CPU-read check comes FIRST, before validity, because a texture that
+   * was never created for reading is a caller mistake rather than a state
+   * problem - which is why it answers `E_INVALIDCALL` and not `E_FAIL`.
+   *
+   * @param {Tr2TextureSubresource} region The subresource to map.
+   * @param {boolean} synchronize Whether to wait for outstanding GPU work.
+   * @param {object} renderContext The context to map against.
+   * @returns {{result: number, data: Uint8Array|null, pitch: number}} The mapping.
    */
   MapForReading(region, synchronize, renderContext) {
     if (!HasFlag(this._cpuUsage, Tr2CpuUsage.READ)) return {
@@ -347,12 +347,12 @@ class Tr2TextureALStub extends Tr2DeviceResourceAL {
     this._ReleaseUnlessKept();
   }
 
-  /**
-   * Allocates and returns the storage for one subresource, for writing.
-   *
-   * @param {Tr2TextureSubresource} region The subresource to map.
-   * @param {object} renderContext The context to map against.
-   * @returns {{result: number, data: Uint8Array|null, pitch: number}} The mapping.
+  /**
+   * Allocates and returns the storage for one subresource, for writing.
+   *
+   * @param {Tr2TextureSubresource} region The subresource to map.
+   * @param {object} renderContext The context to map against.
+   * @returns {{result: number, data: Uint8Array|null, pitch: number}} The mapping.
    */
   MapForWriting(region, renderContext) {
     if (!HasFlag(this._cpuUsage, Tr2CpuUsage.WRITE)) return {
@@ -420,18 +420,18 @@ class Tr2TextureALStub extends Tr2DeviceResourceAL {
     }
   }
 
-  /**
-   * Writes pixels into one subresource.
-   *
-   * A texture mapped often is written through a map, not through this, so
-   * Carbon refuses `WRITE_OFTEN` here outright.
-   *
-   * @param {Tr2TextureSubresource} region The subresource to write.
-   * @param {ArrayBufferView} source The pixels.
-   * @param {number} pitch Bytes per row in the source.
-   * @param {number} slicePitch Bytes per slice in the source.
-   * @param {object} renderContext The context to write against.
-   * @returns {number} An `ALResult` value.
+  /**
+   * Writes pixels into one subresource.
+   *
+   * A texture mapped often is written through a map, not through this, so
+   * Carbon refuses `WRITE_OFTEN` here outright.
+   *
+   * @param {Tr2TextureSubresource} region The subresource to write.
+   * @param {ArrayBufferView} source The pixels.
+   * @param {number} pitch Bytes per row in the source.
+   * @param {number} slicePitch Bytes per slice in the source.
+   * @param {object} renderContext The context to write against.
+   * @returns {number} An `ALResult` value.
    */
   UpdateSubresource(region, source, pitch, slicePitch, renderContext) {
     if (HasFlag(this._cpuUsage, Tr2CpuUsage.WRITE_OFTEN)) return ALResult.E_INVALIDCALL;
@@ -442,17 +442,17 @@ class Tr2TextureALStub extends Tr2DeviceResourceAL {
     return ALResult.S_OK;
   }
 
-  /**
-   * Copies a region from another texture.
-   *
-   * A whole-to-whole copy short-circuits; anything else must survive `Crop`,
-   * which is where a mismatched face count or an empty overlap is caught.
-   *
-   * @param {Tr2TextureSubresource} destSubresource The region to write.
-   * @param {Tr2TextureALStub} source The texture to read.
-   * @param {Tr2TextureSubresource} sourceSubresource The region to read.
-   * @param {object} renderContext The context to copy against.
-   * @returns {number} An `ALResult` value.
+  /**
+   * Copies a region from another texture.
+   *
+   * A whole-to-whole copy short-circuits; anything else must survive `Crop`,
+   * which is where a mismatched face count or an empty overlap is caught.
+   *
+   * @param {Tr2TextureSubresource} destSubresource The region to write.
+   * @param {Tr2TextureALStub} source The texture to read.
+   * @param {Tr2TextureSubresource} sourceSubresource The region to read.
+   * @param {object} renderContext The context to copy against.
+   * @returns {number} An `ALResult` value.
    */
   CopySubresourceRegion(destSubresource, source, sourceSubresource, renderContext) {
     if (!this.IsValid() || !renderContext.IsValid()) return ALResult.E_INVALIDCALL;
@@ -470,13 +470,13 @@ class Tr2TextureALStub extends Tr2DeviceResourceAL {
     return ALResult.S_OK;
   }
 
-  /**
-   * Regenerates the mip chain.
-   *
-   * Only a texture that is both a render target and a shader resource can be
-   * generated into, because that is how the hardware does it.
-   *
-   * @returns {number} An `ALResult` value.
+  /**
+   * Regenerates the mip chain.
+   *
+   * Only a texture that is both a render target and a shader resource can be
+   * generated into, because that is how the hardware does it.
+   *
+   * @returns {number} An `ALResult` value.
    */
   GenerateMipMaps() {
     if (!HasFlag(this._gpuUsage, Tr2GpuUsage.RENDER_TARGET) || !HasFlag(this._gpuUsage, Tr2GpuUsage.SHADER_RESOURCE)) {
@@ -485,15 +485,15 @@ class Tr2TextureALStub extends Tr2DeviceResourceAL {
     return ALResult.S_OK;
   }
 
-  /**
-   * Resolves a multisampled texture into a single-sampled one.
-   *
-   * With one sample there is nothing to resolve, so Carbon falls back to a
-   * plain copy - and inherits that copy's validation with it.
-   *
-   * @param {Tr2TextureALStub} destination The texture to resolve into.
-   * @param {object} renderContext The context to resolve against.
-   * @returns {number} An `ALResult` value.
+  /**
+   * Resolves a multisampled texture into a single-sampled one.
+   *
+   * With one sample there is nothing to resolve, so Carbon falls back to a
+   * plain copy - and inherits that copy's validation with it.
+   *
+   * @param {Tr2TextureALStub} destination The texture to resolve into.
+   * @param {object} renderContext The context to resolve against.
+   * @returns {number} An `ALResult` value.
    */
   Resolve(destination, renderContext) {
     if (this._msaa.samples <= 1) {
@@ -512,58 +512,58 @@ class Tr2TextureALStub extends Tr2DeviceResourceAL {
     return ALResult.S_OK;
   }
 
-  /**
-   * The handle another device could open this texture by.
-   *
-   * @returns {number} Always zero; the stub shares nothing.
+  /**
+   * The handle another device could open this texture by.
+   *
+   * @returns {number} Always zero; the stub shares nothing.
    */
   GetSharedHandle() {
     return 0;
   }
 
-  /**
-   * Where the shader-resource view sits in the descriptor heap.
-   *
-   * @returns {number} Carbon's "no index".
+  /**
+   * Where the shader-resource view sits in the descriptor heap.
+   *
+   * @returns {number} Carbon's "no index".
    */
   GetSrvIndexInHeap() {
     return NO_HEAP_INDEX;
   }
 
-  /**
-   * Where the unordered-access view sits in the descriptor heap.
-   *
-   * @returns {number} Carbon's "no index".
+  /**
+   * Where the unordered-access view sits in the descriptor heap.
+   *
+   * @returns {number} Carbon's "no index".
    */
   GetUavIndexInHeap() {
     return NO_HEAP_INDEX;
   }
 
-  /**
-   * Names the texture for a debugger.
-   *
-   * @param {string} _name The name Carbon would attach; the stub discards it.
-   * @returns {number} An `ALResult` value; the stub keeps no name.
+  /**
+   * Names the texture for a debugger.
+   *
+   * @param {string} _name The name Carbon would attach; the stub discards it.
+   * @returns {number} An `ALResult` value; the stub keeps no name.
    */
   SetName(_name) {
     return ALResult.S_OK;
   }
 
-  /**
-   * The debug name.
-   *
-   * @returns {null} Always null, as Carbon's stub returns.
+  /**
+   * The debug name.
+   *
+   * @returns {null} Always null, as Carbon's stub returns.
    */
   GetName() {
     return null;
   }
 }
 
-/**
- * Copies a subresource region, so a call that crops does not alter its caller.
- *
- * @param {Tr2TextureSubresource} region The region to copy.
- * @returns {Tr2TextureSubresource} An independent copy.
+/**
+ * Copies a subresource region, so a call that crops does not alter its caller.
+ *
+ * @param {Tr2TextureSubresource} region The region to copy.
+ * @returns {Tr2TextureSubresource} An independent copy.
  */
 function CopyRegion(region) {
   const copy = new Tr2TextureSubresource();