@carbonenginejs/runtime 0.1.0-alpha.6 → 0.1.0-alpha.7

package/dist/resource/formats/webgpu/core/wgsl/wgslTypedViews.js

@@ -1,15 +1,39 @@
-import { CARBON_VIEW_FORMATS } from '../../../hlsl/core/carbonTypedViews.js';
+import { CARBON_VIEW_FORMATS, unboundUavRegistersFor } from '../../../hlsl/core/carbonTypedViews.js';
 
-/**
- * What each Carbon view format (`hlsl/core/carbonTypedViews.js`) means to WGSL:
- * the storage element, the WebGPU storage-texture format, and the
- * four-component value D3D11 returns for an in-bounds element (missing
- * channels 0, alpha 1). Both are single-channel 32-bit formats, which WebGPU
- * allows as read-write storage textures.
- *
- * A uint view applies to render stages only: compute already reads uint
- * buffers as raw words and writes uint UAVs atomically, in the audited
- * histogram profiles among others, and those layouts stay as they are.
+/**
+ * The shader program without the UAVs Carbon never binds
+ * (`CARBON_UNBOUND_UAVS`): their bindings leave the binding list, and
+ * `unboundUavRegisters` names their registers, whose stores then lower to
+ * nothing, as D3D11 drops a write to an empty UAV slot. The instructions and
+ * blocks are untouched, so every position the program records still holds.
+ *
+ * @param {object} program Frozen CJS shader IR.
+ * @param {object[]} semanticBindings The stage's effect-description bindings.
+ * @returns {object} The program, or a copy without those UAVs.
+ */
+function withoutUnboundUavs(program, semanticBindings) {
+  const registers = unboundUavRegistersFor(semanticBindings);
+  if (!registers.length) return program;
+  const unbound = new Set(registers);
+  const bindings = program.bindings.filter(binding => !(binding.resourceKind === "storage-resource" && (binding.range?.registerSpace ?? 0) === 0 && unbound.has(binding.range?.lowerBound ?? binding.registerIndex)));
+  return Object.freeze({
+    ...program,
+    bindings: Object.freeze(bindings),
+    unboundUavRegisters: Object.freeze(registers)
+  });
+}
+
+/**
+ * What each Carbon view format (`hlsl/core/carbonTypedViews.js`) means to WGSL:
+ * the storage element, the WebGPU storage-texture format, and the
+ * four-component value D3D11 returns for an in-bounds element (missing
+ * channels 0, alpha 1). The two single-channel 32-bit formats are ones WebGPU
+ * allows as read-write storage textures; a `writeOnly` format is a write-only
+ * storage texture and never a typed buffer.
+ *
+ * A uint view applies to render stages only: compute already reads uint
+ * buffers as raw words and writes uint UAVs atomically, in the audited
+ * histogram profiles among others, and those layouts stay as they are.
  */
 const TYPED_VIEW_FORMATS = Object.freeze({
   R32_FLOAT: Object.freeze({
@@ -25,6 +49,24 @@ const TYPED_VIEW_FORMATS = Object.freeze({
     storageTextureFormat: "r32uint",
     renderStagesOnly: true,
     expand: value => `vec4<u32>(${value}, 0u, 0u, 1u)`
+  }),
+  R32_SINT: Object.freeze({
+    returnType: CARBON_VIEW_FORMATS.R32_SINT.componentClass,
+    element: "i32",
+    storageTextureFormat: "r32sint",
+    renderStagesOnly: true,
+    expand: value => `vec4<i32>(${value}, 0i, 0i, 1i)`
+  }),
+  // Four channels: a write-only storage texture and nothing else. Core
+  // WebGPU has no read-write rgba8snorm, and no typed buffer takes it, since
+  // an array element cannot hold four packed snorm bytes.
+  R8G8B8A8_SNORM: Object.freeze({
+    returnType: CARBON_VIEW_FORMATS.R8G8B8A8_SNORM.componentClass,
+    element: "f32",
+    storageTextureFormat: "rgba8snorm",
+    renderStagesOnly: false,
+    writeOnly: true,
+    expand: value => value
   })
 });
 const SCALAR_EXPANSION = Object.freeze({
@@ -33,21 +75,21 @@ const SCALAR_EXPANSION = Object.freeze({
   i32: value => `vec4<i32>(${value}, 0i, 0i, 1i)`
 });
 
-/**
- * A typed-buffer `ld` from a storage array of `element`, zero out of bounds.
- *
- * D3D's `ld` always returns four components, so a scalar element (a
- * single-channel buffer, such as the R32_UINT histogram a compute program
- * reads) widens as a single-channel format does - missing channels 0, alpha 1
- * - and the instruction's swizzle then applies to a vector, as it must.
- * Without the widening a `.x` landed on a scalar: "cannot index into
- * expression of type 'u32'". A vector element is returned as it is.
- *
- * @param {string} element The array's element type, e.g. `u32` or `vec4<f32>`.
- * @param {string} symbol The storage array's name.
- * @param {string} address The element index expression.
- * @param {string} length The array-length expression.
- * @returns {string} A four-component WGSL expression.
+/**
+ * A typed-buffer `ld` from a storage array of `element`, zero out of bounds.
+ *
+ * D3D's `ld` always returns four components, so a scalar element (a
+ * single-channel buffer, such as the R32_UINT histogram a compute program
+ * reads) widens as a single-channel format does - missing channels 0, alpha 1
+ * - and the instruction's swizzle then applies to a vector, as it must.
+ * Without the widening a `.x` landed on a scalar: "cannot index into
+ * expression of type 'u32'". A vector element is returned as it is.
+ *
+ * @param {string} element The array's element type, e.g. `u32` or `vec4<f32>`.
+ * @param {string} symbol The storage array's name.
+ * @param {string} address The element index expression.
+ * @param {string} length The array-length expression.
+ * @returns {string} A four-component WGSL expression.
  */
 function typedBufferLoad(element, symbol, address, length) {
   const expand = SCALAR_EXPANSION[element];
@@ -55,5 +97,5 @@ function typedBufferLoad(element, symbol, address, length) {
   return expand ? `select(vec4<${element}>(), ${expand(clamped)}, ${address} < ${length})` : `select(${element}(), ${clamped}, ${address} < ${length})`;
 }
 
-export { TYPED_VIEW_FORMATS, typedBufferLoad };
+export { TYPED_VIEW_FORMATS, typedBufferLoad, withoutUnboundUavs };
 //# sourceMappingURL=wgslTypedViews.js.map

package/dist/resource/formats/webgpu/core/wgsl/wgslTypedViews.js.map

@@ -1 +1 @@
-{"version":3,"file":"wgslTypedViews.js","sources":["../../../../../../../src/resource/formats/webgpu/core/wgsl/wgslTypedViews.js"],"sourcesContent":["import { CARBON_VIEW_FORMATS } from \"../../../hlsl/core/carbonTypedViews.js\";\n\n/**\n * What each Carbon view format (`hlsl/core/carbonTypedViews.js`) means to WGSL:\n * the storage element, the WebGPU storage-texture format, and the\n * four-component value D3D11 returns for an in-bounds element (missing\n * channels 0, alpha 1). Both are single-channel 32-bit formats, which WebGPU\n * allows as read-write storage textures.\n *\n * A uint view applies to render stages only: compute already reads uint\n * buffers as raw words and writes uint UAVs atomically, in the audited\n * histogram profiles among others, and those layouts stay as they are.\n */\nexport const TYPED_VIEW_FORMATS = Object.freeze({\n    R32_FLOAT: Object.freeze({\n        returnType: CARBON_VIEW_FORMATS.R32_FLOAT.componentClass,\n        element: \"f32\",\n        storageTextureFormat: \"r32float\",\n        renderStagesOnly: false,\n        expand: (value) => `vec4<f32>(${value}, 0.0, 0.0, 1.0)`\n    }),\n    R32_UINT: Object.freeze({\n        returnType: CARBON_VIEW_FORMATS.R32_UINT.componentClass,\n        element: \"u32\",\n        storageTextureFormat: \"r32uint\",\n        renderStagesOnly: true,\n        expand: (value) => `vec4<u32>(${value}, 0u, 0u, 1u)`\n    })\n});\n\nconst SCALAR_EXPANSION = Object.freeze({\n    f32: (value) => `vec4<f32>(${value}, 0.0, 0.0, 1.0)`,\n    u32: (value) => `vec4<u32>(${value}, 0u, 0u, 1u)`,\n    i32: (value) => `vec4<i32>(${value}, 0i, 0i, 1i)`\n});\n\n/**\n * A typed-buffer `ld` from a storage array of `element`, zero out of bounds.\n *\n * D3D's `ld` always returns four components, so a scalar element (a\n * single-channel buffer, such as the R32_UINT histogram a compute program\n * reads) widens as a single-channel format does - missing channels 0, alpha 1\n * - and the instruction's swizzle then applies to a vector, as it must.\n * Without the widening a `.x` landed on a scalar: \"cannot index into\n * expression of type 'u32'\". A vector element is returned as it is.\n *\n * @param {string} element The array's element type, e.g. `u32` or `vec4<f32>`.\n * @param {string} symbol The storage array's name.\n * @param {string} address The element index expression.\n * @param {string} length The array-length expression.\n * @returns {string} A four-component WGSL expression.\n */\nexport function typedBufferLoad(element, symbol, address, length)\n{\n    const expand = SCALAR_EXPANSION[element];\n    const clamped = `${symbol}[min(${address}, ${length} - 1u)]`;\n\n    return expand\n        ? `select(vec4<${element}>(), ${expand(clamped)}, ${address} < ${length})`\n        : `select(${element}(), ${clamped}, ${address} < ${length})`;\n}\n"],"names":["TYPED_VIEW_FORMATS","Object","freeze","R32_FLOAT","returnType","CARBON_VIEW_FORMATS","componentClass","element","storageTextureFormat","renderStagesOnly","expand","value","R32_UINT","SCALAR_EXPANSION","f32","u32","i32","typedBufferLoad","symbol","address","length","clamped"],"mappings":";;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;MACaA,kBAAkB,GAAGC,MAAM,CAACC,MAAM,CAAC;AAC5CC,EAAAA,SAAS,EAAEF,MAAM,CAACC,MAAM,CAAC;AACrBE,IAAAA,UAAU,EAAEC,mBAAmB,CAACF,SAAS,CAACG,cAAc;AACxDC,IAAAA,OAAO,EAAE,KAAK;AACdC,IAAAA,oBAAoB,EAAE,UAAU;AAChCC,IAAAA,gBAAgB,EAAE,KAAK;AACvBC,IAAAA,MAAM,EAAGC,KAAK,IAAK,CAAA,UAAA,EAAaA,KAAK,CAAA,gBAAA;AACzC,GAAC,CAAC;AACFC,EAAAA,QAAQ,EAAEX,MAAM,CAACC,MAAM,CAAC;AACpBE,IAAAA,UAAU,EAAEC,mBAAmB,CAACO,QAAQ,CAACN,cAAc;AACvDC,IAAAA,OAAO,EAAE,KAAK;AACdC,IAAAA,oBAAoB,EAAE,SAAS;AAC/BC,IAAAA,gBAAgB,EAAE,IAAI;AACtBC,IAAAA,MAAM,EAAGC,KAAK,IAAK,CAAA,UAAA,EAAaA,KAAK,CAAA,aAAA;GACxC;AACL,CAAC;AAED,MAAME,gBAAgB,GAAGZ,MAAM,CAACC,MAAM,CAAC;AACnCY,EAAAA,GAAG,EAAGH,KAAK,IAAK,CAAA,UAAA,EAAaA,KAAK,CAAA,gBAAA,CAAkB;AACpDI,EAAAA,GAAG,EAAGJ,KAAK,IAAK,CAAA,UAAA,EAAaA,KAAK,CAAA,aAAA,CAAe;AACjDK,EAAAA,GAAG,EAAGL,KAAK,IAAK,CAAA,UAAA,EAAaA,KAAK,CAAA,aAAA;AACtC,CAAC,CAAC;;AAEF;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASM,eAAeA,CAACV,OAAO,EAAEW,MAAM,EAAEC,OAAO,EAAEC,MAAM,EAChE;AACI,EAAA,MAAMV,MAAM,GAAGG,gBAAgB,CAACN,OAAO,CAAC;EACxC,MAAMc,OAAO,GAAG,CAAA,EAAGH,MAAM,QAAQC,OAAO,CAAA,EAAA,EAAKC,MAAM,CAAA,OAAA,CAAS;EAE5D,OAAOV,MAAM,GACP,CAAA,YAAA,EAAeH,OAAO,QAAQG,MAAM,CAACW,OAAO,CAAC,CAAA,EAAA,EAAKF,OAAO,MAAMC,MAAM,CAAA,CAAA,CAAG,GACxE,CAAA,OAAA,EAAUb,OAAO,CAAA,IAAA,EAAOc,OAAO,CAAA,EAAA,EAAKF,OAAO,CAAA,GAAA,EAAMC,MAAM,CAAA,CAAA,CAAG;AACpE;;;;"}
+{"version":3,"file":"wgslTypedViews.js","sources":["../../../../../../../src/resource/formats/webgpu/core/wgsl/wgslTypedViews.js"],"sourcesContent":["import { CARBON_VIEW_FORMATS, unboundUavRegistersFor } from \"../../../hlsl/core/carbonTypedViews.js\";\r\n\r\n/**\r\n * The shader program without the UAVs Carbon never binds\r\n * (`CARBON_UNBOUND_UAVS`): their bindings leave the binding list, and\r\n * `unboundUavRegisters` names their registers, whose stores then lower to\r\n * nothing, as D3D11 drops a write to an empty UAV slot. The instructions and\r\n * blocks are untouched, so every position the program records still holds.\r\n *\r\n * @param {object} program Frozen CJS shader IR.\r\n * @param {object[]} semanticBindings The stage's effect-description bindings.\r\n * @returns {object} The program, or a copy without those UAVs.\r\n */\r\nexport function withoutUnboundUavs(program, semanticBindings)\r\n{\r\n    const registers = unboundUavRegistersFor(semanticBindings);\r\n    if (!registers.length) return program;\r\n\r\n    const unbound = new Set(registers);\r\n    const bindings = program.bindings.filter((binding) => !(binding.resourceKind === \"storage-resource\"\r\n        && (binding.range?.registerSpace ?? 0) === 0\r\n        && unbound.has(binding.range?.lowerBound ?? binding.registerIndex)));\r\n\r\n    return Object.freeze({\r\n        ...program,\r\n        bindings: Object.freeze(bindings),\r\n        unboundUavRegisters: Object.freeze(registers)\r\n    });\r\n}\r\n\r\n/**\r\n * What each Carbon view format (`hlsl/core/carbonTypedViews.js`) means to WGSL:\r\n * the storage element, the WebGPU storage-texture format, and the\r\n * four-component value D3D11 returns for an in-bounds element (missing\r\n * channels 0, alpha 1). The two single-channel 32-bit formats are ones WebGPU\r\n * allows as read-write storage textures; a `writeOnly` format is a write-only\r\n * storage texture and never a typed buffer.\r\n *\r\n * A uint view applies to render stages only: compute already reads uint\r\n * buffers as raw words and writes uint UAVs atomically, in the audited\r\n * histogram profiles among others, and those layouts stay as they are.\r\n */\r\nexport const TYPED_VIEW_FORMATS = Object.freeze({\r\n    R32_FLOAT: Object.freeze({\r\n        returnType: CARBON_VIEW_FORMATS.R32_FLOAT.componentClass,\r\n        element: \"f32\",\r\n        storageTextureFormat: \"r32float\",\r\n        renderStagesOnly: false,\r\n        expand: (value) => `vec4<f32>(${value}, 0.0, 0.0, 1.0)`\r\n    }),\r\n    R32_UINT: Object.freeze({\r\n        returnType: CARBON_VIEW_FORMATS.R32_UINT.componentClass,\r\n        element: \"u32\",\r\n        storageTextureFormat: \"r32uint\",\r\n        renderStagesOnly: true,\r\n        expand: (value) => `vec4<u32>(${value}, 0u, 0u, 1u)`\r\n    }),\r\n    R32_SINT: Object.freeze({\r\n        returnType: CARBON_VIEW_FORMATS.R32_SINT.componentClass,\r\n        element: \"i32\",\r\n        storageTextureFormat: \"r32sint\",\r\n        renderStagesOnly: true,\r\n        expand: (value) => `vec4<i32>(${value}, 0i, 0i, 1i)`\r\n    }),\r\n    // Four channels: a write-only storage texture and nothing else. Core\r\n    // WebGPU has no read-write rgba8snorm, and no typed buffer takes it, since\r\n    // an array element cannot hold four packed snorm bytes.\r\n    R8G8B8A8_SNORM: Object.freeze({\r\n        returnType: CARBON_VIEW_FORMATS.R8G8B8A8_SNORM.componentClass,\r\n        element: \"f32\",\r\n        storageTextureFormat: \"rgba8snorm\",\r\n        renderStagesOnly: false,\r\n        writeOnly: true,\r\n        expand: (value) => value\r\n    })\r\n});\r\n\r\nconst SCALAR_EXPANSION = Object.freeze({\r\n    f32: (value) => `vec4<f32>(${value}, 0.0, 0.0, 1.0)`,\r\n    u32: (value) => `vec4<u32>(${value}, 0u, 0u, 1u)`,\r\n    i32: (value) => `vec4<i32>(${value}, 0i, 0i, 1i)`\r\n});\r\n\r\n/**\r\n * A typed-buffer `ld` from a storage array of `element`, zero out of bounds.\r\n *\r\n * D3D's `ld` always returns four components, so a scalar element (a\r\n * single-channel buffer, such as the R32_UINT histogram a compute program\r\n * reads) widens as a single-channel format does - missing channels 0, alpha 1\r\n * - and the instruction's swizzle then applies to a vector, as it must.\r\n * Without the widening a `.x` landed on a scalar: \"cannot index into\r\n * expression of type 'u32'\". A vector element is returned as it is.\r\n *\r\n * @param {string} element The array's element type, e.g. `u32` or `vec4<f32>`.\r\n * @param {string} symbol The storage array's name.\r\n * @param {string} address The element index expression.\r\n * @param {string} length The array-length expression.\r\n * @returns {string} A four-component WGSL expression.\r\n */\r\nexport function typedBufferLoad(element, symbol, address, length)\r\n{\r\n    const expand = SCALAR_EXPANSION[element];\r\n    const clamped = `${symbol}[min(${address}, ${length} - 1u)]`;\r\n\r\n    return expand\r\n        ? `select(vec4<${element}>(), ${expand(clamped)}, ${address} < ${length})`\r\n        : `select(${element}(), ${clamped}, ${address} < ${length})`;\r\n}\r\n"],"names":["withoutUnboundUavs","program","semanticBindings","registers","unboundUavRegistersFor","length","unbound","Set","bindings","filter","binding","resourceKind","range","registerSpace","has","lowerBound","registerIndex","Object","freeze","unboundUavRegisters","TYPED_VIEW_FORMATS","R32_FLOAT","returnType","CARBON_VIEW_FORMATS","componentClass","element","storageTextureFormat","renderStagesOnly","expand","value","R32_UINT","R32_SINT","R8G8B8A8_SNORM","writeOnly","SCALAR_EXPANSION","f32","u32","i32","typedBufferLoad","symbol","address","clamped"],"mappings":"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"}

package/dist/resource/geometry/registerGeometryResources.js

@@ -27,7 +27,16 @@ function RegisterGeometryResources(resourceManager) {
   if (typeof resourceManager?.RegisterExtension !== "function" || typeof resourceManager?.RegisterObjectLoader !== "function") {
     throw new TypeError("RegisterGeometryResources requires a CjsResMan.");
   }
-  const loader = bytes => CjsCmfFormat.loadShared(CjsGr2Format.read(bytes));
+
+  // BOUNDS FROM THE VERTICES. A granny file carries no mesh-level box, and
+  // Carbon's TriGeometryRes::SetupModels starts each mesh's box empty and
+  // accumulates it from the vertices (TriGeometryRes.cpp:1016-1017). Without
+  // the rebuild every mesh read as a zero box, a zero-radius sphere and zero
+  // pixels on screen, so EveTransform culled it: the lens-flare occluder
+  // sprites (zsprite.gr2) never drew, and the flare shone through hulls.
+  const loader = bytes => CjsCmfFormat.loadShared(CjsGr2Format.read(bytes, {
+    rebuildMissingBounds: true
+  }));
   for (const extension of GeometryResourceExtensions) {
     resourceManager.RegisterObjectLoader(extension, loader);
     resourceManager.RegisterExtension(extension, TriGeometryRes);

package/dist/resource/geometry/registerGeometryResources.js.map

@@ -1 +1 @@
-{"version":3,"file":"registerGeometryResources.js","sources":["../../../../src/resource/geometry/registerGeometryResources.js"],"sourcesContent":["// REGISTERS THE GEOMETRY RESOURCE ROUTE: `.gr2` -> TriGeometryRes, the resource\n// a Tr2Mesh asks the manager for (`Tr2Mesh.Initialize`, requirement GEOMETRY).\n// Beside RegisterTextureResources and RegisterShaderResources, and for the same\n// reason: the manager knows no resource type until composition registers one,\n// and without this a SOF-built ship's mesh stayed a failed resource.\n//\n// The payload is the CMF projection of the granny file: `CjsGr2Format.read`\n// gives shared geometry and `CjsCmfFormat.loadShared` projects it to the\n// meshes/areas/declaration graph TriGeometryRes and the mesh draw path read.\n// Both are the formats' public one-shot readers; nothing format-internal is\n// reached from here.\nimport { CjsGr2Format } from \"../formats/gr2/index.js\";\nimport { CjsCmfFormat } from \"../formats/cmf/index.js\";\nimport { TriGeometryRes } from \"./TriGeometryRes.js\";\n\n/** The extensions Carbon loads as geometry resources. */\nexport const GeometryResourceExtensions = Object.freeze([ \"gr2\" ]);\n\n/**\n * Routes granny geometry files to TriGeometryRes on a resource manager.\n *\n * @param {object} resourceManager A CjsResMan.\n * @returns {object} The same manager, for chaining.\n */\nexport function RegisterGeometryResources(resourceManager)\n{\n  if (typeof resourceManager?.RegisterExtension !== \"function\"\n    || typeof resourceManager?.RegisterObjectLoader !== \"function\")\n  {\n    throw new TypeError(\"RegisterGeometryResources requires a CjsResMan.\");\n  }\n\n  const loader = bytes => CjsCmfFormat.loadShared(CjsGr2Format.read(bytes));\n\n  for (const extension of GeometryResourceExtensions)\n  {\n    resourceManager.RegisterObjectLoader(extension, loader);\n    resourceManager.RegisterExtension(extension, TriGeometryRes);\n  }\n\n  return resourceManager;\n}\n"],"names":["GeometryResourceExtensions","Object","freeze","RegisterGeometryResources","resourceManager","RegisterExtension","RegisterObjectLoader","TypeError","loader","bytes","CjsCmfFormat","loadShared","CjsGr2Format","read","extension","TriGeometryRes"],"mappings":";;;;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAKA;AACO,MAAMA,0BAA0B,GAAGC,MAAM,CAACC,MAAM,CAAC,CAAE,KAAK,CAAE;;AAEjE;AACA;AACA;AACA;AACA;AACA;AACO,SAASC,yBAAyBA,CAACC,eAAe,EACzD;AACE,EAAA,IAAI,OAAOA,eAAe,EAAEC,iBAAiB,KAAK,UAAU,IACvD,OAAOD,eAAe,EAAEE,oBAAoB,KAAK,UAAU,EAChE;AACE,IAAA,MAAM,IAAIC,SAAS,CAAC,iDAAiD,CAAC;AACxE,EAAA;AAEA,EAAA,MAAMC,MAAM,GAAGC,KAAK,IAAIC,YAAY,CAACC,UAAU,CAACC,YAAY,CAACC,IAAI,CAACJ,KAAK,CAAC,CAAC;AAEzE,EAAA,KAAK,MAAMK,SAAS,IAAId,0BAA0B,EAClD;AACEI,IAAAA,eAAe,CAACE,oBAAoB,CAACQ,SAAS,EAAEN,MAAM,CAAC;AACvDJ,IAAAA,eAAe,CAACC,iBAAiB,CAACS,SAAS,EAAEC,cAAc,CAAC;AAC9D,EAAA;AAEA,EAAA,OAAOX,eAAe;AACxB;;;;"}
+{"version":3,"file":"registerGeometryResources.js","sources":["../../../../src/resource/geometry/registerGeometryResources.js"],"sourcesContent":["// REGISTERS THE GEOMETRY RESOURCE ROUTE: `.gr2` -> TriGeometryRes, the resource\n// a Tr2Mesh asks the manager for (`Tr2Mesh.Initialize`, requirement GEOMETRY).\n// Beside RegisterTextureResources and RegisterShaderResources, and for the same\n// reason: the manager knows no resource type until composition registers one,\n// and without this a SOF-built ship's mesh stayed a failed resource.\n//\n// The payload is the CMF projection of the granny file: `CjsGr2Format.read`\n// gives shared geometry and `CjsCmfFormat.loadShared` projects it to the\n// meshes/areas/declaration graph TriGeometryRes and the mesh draw path read.\n// Both are the formats' public one-shot readers; nothing format-internal is\n// reached from here.\nimport { CjsGr2Format } from \"../formats/gr2/index.js\";\nimport { CjsCmfFormat } from \"../formats/cmf/index.js\";\nimport { TriGeometryRes } from \"./TriGeometryRes.js\";\n\n/** The extensions Carbon loads as geometry resources. */\nexport const GeometryResourceExtensions = Object.freeze([ \"gr2\" ]);\n\n/**\n * Routes granny geometry files to TriGeometryRes on a resource manager.\n *\n * @param {object} resourceManager A CjsResMan.\n * @returns {object} The same manager, for chaining.\n */\nexport function RegisterGeometryResources(resourceManager)\n{\n  if (typeof resourceManager?.RegisterExtension !== \"function\"\n    || typeof resourceManager?.RegisterObjectLoader !== \"function\")\n  {\n    throw new TypeError(\"RegisterGeometryResources requires a CjsResMan.\");\n  }\n\n  // BOUNDS FROM THE VERTICES. A granny file carries no mesh-level box, and\n  // Carbon's TriGeometryRes::SetupModels starts each mesh's box empty and\n  // accumulates it from the vertices (TriGeometryRes.cpp:1016-1017). Without\n  // the rebuild every mesh read as a zero box, a zero-radius sphere and zero\n  // pixels on screen, so EveTransform culled it: the lens-flare occluder\n  // sprites (zsprite.gr2) never drew, and the flare shone through hulls.\n  const loader = bytes => CjsCmfFormat.loadShared(CjsGr2Format.read(bytes, { rebuildMissingBounds: true }));\n\n  for (const extension of GeometryResourceExtensions)\n  {\n    resourceManager.RegisterObjectLoader(extension, loader);\n    resourceManager.RegisterExtension(extension, TriGeometryRes);\n  }\n\n  return resourceManager;\n}\n"],"names":["GeometryResourceExtensions","Object","freeze","RegisterGeometryResources","resourceManager","RegisterExtension","RegisterObjectLoader","TypeError","loader","bytes","CjsCmfFormat","loadShared","CjsGr2Format","read","rebuildMissingBounds","extension","TriGeometryRes"],"mappings":";;;;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAKA;AACO,MAAMA,0BAA0B,GAAGC,MAAM,CAACC,MAAM,CAAC,CAAE,KAAK,CAAE;;AAEjE;AACA;AACA;AACA;AACA;AACA;AACO,SAASC,yBAAyBA,CAACC,eAAe,EACzD;AACE,EAAA,IAAI,OAAOA,eAAe,EAAEC,iBAAiB,KAAK,UAAU,IACvD,OAAOD,eAAe,EAAEE,oBAAoB,KAAK,UAAU,EAChE;AACE,IAAA,MAAM,IAAIC,SAAS,CAAC,iDAAiD,CAAC;AACxE,EAAA;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA,EAAA,MAAMC,MAAM,GAAGC,KAAK,IAAIC,YAAY,CAACC,UAAU,CAACC,YAAY,CAACC,IAAI,CAACJ,KAAK,EAAE;AAAEK,IAAAA,oBAAoB,EAAE;AAAK,GAAC,CAAC,CAAC;AAEzG,EAAA,KAAK,MAAMC,SAAS,IAAIf,0BAA0B,EAClD;AACEI,IAAAA,eAAe,CAACE,oBAAoB,CAACS,SAAS,EAAEP,MAAM,CAAC;AACvDJ,IAAAA,eAAe,CAACC,iBAAiB,CAACU,SAAS,EAAEC,cAAc,CAAC;AAC9D,EAAA;AAEA,EAAA,OAAOZ,eAAe;AACxB;;;;"}

package/dist/sof/EveSOFDNA.js

@@ -860,7 +860,9 @@ new class extends _identity {
 
     /** Reports whether the first selected hull is authored to cast shadows. */
     CastShadow() {
-      return this.hullDatas[0]?.castShadow === true;
+      // EveSOFDataHull defaults m_castShadow to true (EveSOFData.cpp:347), and a
+      // .black record omits a field at its default: absent means true.
+      return this.hullDatas[0]?.castShadow !== false;
     }
 
     /**
@@ -1126,7 +1128,7 @@ function createCustomHullData(source, variant) {
     isSkinned: source?.isSkinned === true,
     isUsingDecalSets: false,
     enableDynamicBoundingSphere: source?.enableDynamicBoundingSphere === true,
-    castShadow: source?.castShadow === true,
+    castShadow: source?.castShadow !== false,
     sof6: false,
     audioPosition: copyArrayValue(source?.audioPosition, [0, 0, 0]),
     spriteSets: [],