@carbonenginejs/runtime-resource 0.8.0 → 0.9.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +21 -21
- package/NOTICE +29 -29
- package/README.md +67 -548
- package/dist/CjsMotherLode.js +1271 -1271
- package/dist/CjsResMan.js +3005 -3005
- package/dist/CjsResManQueue.js +214 -214
- package/dist/CjsResource.js +566 -566
- package/dist/CjsResourceSource.js +59 -59
- package/dist/_virtual/_rollupPluginBabelHelpers.js +153 -153
- package/dist/format/CjsBlueReader.js +269 -269
- package/dist/format/CjsFormat.js +192 -192
- package/dist/format/CjsReader.js +18 -18
- package/dist/format/CjsResourceProbe.js +277 -277
- package/dist/format/payloadContract.js +173 -173
- package/dist/formats/black/CjsBlackFormat.js +278 -278
- package/dist/formats/black/core/CjsBlackBinaryReader.js +153 -153
- package/dist/formats/black/core/CjsBlackPropertyReaders.js +382 -382
- package/dist/formats/black/core/CjsBlackReader.js +639 -639
- package/dist/formats/black/core/CjsBlackSchemaRegistry.js +433 -433
- package/dist/formats/black/core/black-schema-v1-2026-07-11.json.js +4 -4
- package/dist/formats/black/core/blackConstants.js +7 -7
- package/dist/formats/black/core/blackDefinitions.js +10 -10
- package/dist/formats/black/core/blackEnums.js +6 -6
- package/dist/formats/black/core/blackSchema.js +3 -3
- package/dist/formats/black/core/blackVersion.js +22 -22
- package/dist/formats/black/core/helpers.js +182 -182
- package/dist/formats/black/core/schema.js +4 -4
- package/dist/formats/black/index.js +2 -2
- package/dist/formats/bnk/CjsBnkFormat.js +125 -125
- package/dist/formats/bnk/core/graph.js +140 -140
- package/dist/formats/bnk/core/helpers.js +409 -409
- package/dist/formats/bnk/core/musicNodes.js +489 -489
- package/dist/formats/bnk/core/soundbanksInfo.js +246 -246
- package/dist/formats/bnk/index.js +2 -2
- package/dist/formats/cmf/CjsCmfFormat.js +497 -497
- package/dist/formats/cmf/core/binary.js +118 -118
- package/dist/formats/cmf/core/buffers.js +233 -233
- package/dist/formats/cmf/core/constants.js +47 -47
- package/dist/formats/cmf/core/gr2Anim.js +453 -453
- package/dist/formats/cmf/core/helpers.js +287 -287
- package/dist/formats/cmf/core/pack.js +276 -276
- package/dist/formats/cmf/core/schema.js +364 -364
- package/dist/formats/cmf/core/shared.js +268 -268
- package/dist/formats/cmf/core/writer.js +517 -517
- package/dist/formats/cmf/index.js +2 -2
- package/dist/formats/dds/CjsDdsFormat.js +193 -193
- package/dist/formats/dds/core/bc6h.js +288 -288
- package/dist/formats/dds/core/bc7.js +251 -251
- package/dist/formats/dds/core/helpers.js +815 -815
- package/dist/formats/dds/index.js +2 -2
- package/dist/formats/fbx/CjsFbxFormat.js +266 -266
- package/dist/formats/fbx/core/helpers.js +3901 -3901
- package/dist/formats/fbx/index.js +2 -2
- package/dist/formats/flac/CjsFlacFormat.js +87 -87
- package/dist/formats/flac/core/helpers.js +295 -295
- package/dist/formats/flac/index.js +2 -2
- package/dist/formats/gif/CjsGifFormat.js +87 -87
- package/dist/formats/gif/core/helpers.js +360 -360
- package/dist/formats/gif/index.js +2 -2
- package/dist/formats/gltf/CjsGltfFormat.js +290 -290
- package/dist/formats/gltf/core/helpers.js +292 -292
- package/dist/formats/gltf/core/json.js +79 -79
- package/dist/formats/gltf/core/parser.js +666 -666
- package/dist/formats/gltf/core/targets.js +163 -163
- package/dist/formats/gltf/index.js +2 -2
- package/dist/formats/gr2/CjsGr2Format.js +46 -0
- package/dist/formats/gr2/CjsGr2Format.js.map +1 -0
- package/dist/formats/gr2/core/CjsFormatGr2.js +273 -0
- package/dist/formats/gr2/core/CjsFormatGr2.js.map +1 -0
- package/dist/formats/gr2/core/bitknit2.js +280 -0
- package/dist/formats/gr2/core/bitknit2.js.map +1 -0
- package/dist/formats/gr2/core/curves.js +1047 -0
- package/dist/formats/gr2/core/curves.js.map +1 -0
- package/dist/formats/gr2/core/gsf.js +72 -0
- package/dist/formats/gr2/core/gsf.js.map +1 -0
- package/dist/formats/gr2/core/helpers.js +332 -0
- package/dist/formats/gr2/core/helpers.js.map +1 -0
- package/dist/formats/gr2/core/json.js +622 -0
- package/dist/formats/gr2/core/json.js.map +1 -0
- package/dist/formats/gr2/core/oodle1.js +388 -0
- package/dist/formats/gr2/core/oodle1.js.map +1 -0
- package/dist/formats/gr2/core/reader.js +617 -0
- package/dist/formats/gr2/core/reader.js.map +1 -0
- package/dist/formats/gr2/core/tangents.js +48 -0
- package/dist/formats/gr2/core/tangents.js.map +1 -0
- package/dist/formats/gr2/core/targets.js +351 -0
- package/dist/formats/gr2/core/targets.js.map +1 -0
- package/dist/formats/gr2/index.js +3 -0
- package/dist/formats/gr2/index.js.map +1 -0
- package/dist/formats/index.js +30 -23
- package/dist/formats/index.js.map +1 -1
- package/dist/formats/jpeg/CjsJpegFormat.js +206 -206
- package/dist/formats/jpeg/core/helpers.js +350 -350
- package/dist/formats/jpeg/core/jpeg.js +377 -377
- package/dist/formats/jpeg/index.js +2 -2
- package/dist/formats/mp3/CjsMp3Format.js +192 -192
- package/dist/formats/mp3/core/helpers.js +338 -338
- package/dist/formats/mp3/index.js +2 -2
- package/dist/formats/mp4/CjsMp4Format.js +191 -191
- package/dist/formats/mp4/core/helpers.js +449 -449
- package/dist/formats/mp4/index.js +2 -2
- package/dist/formats/obj/CjsObjFormat.js +253 -253
- package/dist/formats/obj/core/helpers.js +573 -573
- package/dist/formats/obj/core/json.js +64 -64
- package/dist/formats/obj/core/parser.js +321 -321
- package/dist/formats/obj/index.js +2 -2
- package/dist/formats/ogg/CjsOggFormat.js +88 -88
- package/dist/formats/ogg/core/helpers.js +387 -387
- package/dist/formats/ogg/core/imdct.js +178 -178
- package/dist/formats/ogg/core/vorbis.js +999 -999
- package/dist/formats/ogg/index.js +2 -2
- package/dist/formats/png/CjsPngFormat.js +195 -195
- package/dist/formats/png/core/helpers.js +583 -583
- package/dist/formats/png/index.js +2 -2
- package/dist/formats/red/CjsRedFormat.js +261 -261
- package/dist/formats/red/core/CjsRedReader.js +194 -194
- package/dist/formats/red/core/blackDefinitions.js +3 -3
- package/dist/formats/red/core/helpers.js +139 -139
- package/dist/formats/red/core/redGraph.js +68 -68
- package/dist/formats/red/core/schema.js +4 -4
- package/dist/formats/red/index.js +2 -2
- package/dist/formats/stl/CjsStlFormat.js +365 -365
- package/dist/formats/stl/core/helpers.js +261 -261
- package/dist/formats/stl/core/json.js +51 -51
- package/dist/formats/stl/core/stl.js +629 -629
- package/dist/formats/stl/core/targets.js +163 -163
- package/dist/formats/stl/index.js +2 -2
- package/dist/formats/tga/CjsTgaFormat.js +192 -192
- package/dist/formats/tga/core/helpers.js +446 -446
- package/dist/formats/tga/index.js +2 -2
- package/dist/formats/wav/CjsWavFormat.js +192 -192
- package/dist/formats/wav/core/helpers.js +328 -328
- package/dist/formats/wav/index.js +2 -2
- package/dist/formats/webm/CjsWebmFormat.js +191 -191
- package/dist/formats/webm/core/helpers.js +537 -537
- package/dist/formats/webm/index.js +2 -2
- package/dist/formats/webp/CjsWebpFormat.js +86 -86
- package/dist/formats/webp/core/helpers.js +214 -214
- package/dist/formats/webp/index.js +2 -2
- package/dist/formats/wem/CjsWemFormat.js +241 -241
- package/dist/formats/wem/core/bitStream.js +259 -259
- package/dist/formats/wem/core/codebookLibrary.js +164 -164
- package/dist/formats/wem/core/helpers.js +417 -417
- package/dist/formats/wem/core/packedCodebooksAotuv603.js +30 -30
- package/dist/formats/wem/core/ptadpcm.js +77 -77
- package/dist/formats/wem/core/resolve.js +121 -121
- package/dist/formats/wem/core/wemToOgg.js +485 -485
- package/dist/formats/wem/index.js +2 -2
- package/dist/formats/yaml/CjsYamlFormat.js +83 -83
- package/dist/formats/yaml/core/CjsYamlReader.js +305 -305
- package/dist/formats/yaml/core/helpers.js +160 -160
- package/dist/formats/yaml/index.js +2 -2
- package/dist/index.js +49 -48
- package/dist/index.js.map +1 -1
- package/dist/resourcePath.js +18 -18
- package/dist/resourceStates.js +9 -9
- package/dist/resources/AudioGeometryResData.js +47 -47
- package/dist/resources/GStateBindingCallbackData.js +31 -31
- package/dist/resources/MeshDecalData.js +37 -37
- package/dist/resources/MeshDecalLodData.js +34 -34
- package/dist/resources/Tr2EffectRes.js +71 -71
- package/dist/resources/Tr2GrannyIntersectionResult.js +60 -60
- package/dist/resources/Tr2GrannyStateRes.js +44 -44
- package/dist/resources/Tr2ImageRes.js +114 -114
- package/dist/resources/Tr2LightProfileRes.js +40 -40
- package/dist/resources/Tr2MaterialArea.js +34 -34
- package/dist/resources/Tr2MaterialMesh.js +31 -31
- package/dist/resources/Tr2MaterialRes.js +34 -34
- package/dist/resources/Tr2ShaderPermutation.js +43 -43
- package/dist/resources/Tr2TextureLodManager.js +80 -80
- package/dist/resources/Tr2TextureLodUpdateRequest.js +37 -37
- package/dist/resources/Tr2TexturePackChannel.js +37 -37
- package/dist/resources/Tr2TexturePipeline.js +52 -52
- package/dist/resources/Tr2TexturePipelineParams.js +34 -34
- package/dist/resources/Tr2TexturePipelineStepCompress.js +40 -40
- package/dist/resources/Tr2TexturePipelineStepGenerateMips.js +22 -0
- package/dist/resources/Tr2TexturePipelineStepGenerateMips.js.map +1 -0
- package/dist/resources/Tr2TexturePipelineStepLimitSize.js +34 -34
- package/dist/resources/Tr2TexturePipelineStepLoad.js +31 -31
- package/dist/resources/Tr2TexturePipelineStepPack.js +43 -43
- package/dist/resources/TriGeometryRes.js +239 -239
- package/dist/resources/TriGeometryResAreaData.js +59 -59
- package/dist/resources/TriGeometryResJointData.js +38 -38
- package/dist/resources/TriGeometryResLodData.js +88 -88
- package/dist/resources/TriGeometryResMeshData.js +63 -63
- package/dist/resources/TriGeometryResSkeletonData.js +34 -34
- package/dist/resources/TriGrannyRes.js +43 -43
- package/dist/resources/TriJointBinding.js +38 -38
- package/dist/resources/TriMorphTargetGeometryConstants.js +46 -46
- package/dist/resources/TriRtGeometryConstants.js +88 -88
- package/dist/resources/TriTextureRes.js +304 -304
- package/dist/resources/enums.js +18 -18
- package/dist/resources/resourceBoundary.js +47 -47
- package/dist/resources/texturePipelineBehavior.js +308 -308
- package/dist/texture/CjsTextureArrayRes.js +406 -406
- package/dist/texture/CjsTextureParameterProxy.js +133 -133
- package/docs/README.md +69 -0
- package/docs/architecture.md +86 -0
- package/docs/concepts/resource-lifecycle.md +217 -0
- package/docs/formats/README.md +104 -0
- package/{FORMAT-PROVENANCE.md → docs/formats/provenance.md} +173 -155
- package/docs/formats/stl.md +37 -0
- package/docs/formats/wwise.md +44 -0
- package/docs/reference/events.md +92 -0
- package/docs/reference/motherlode-cache.md +244 -0
- package/docs/reference/queues.md +102 -0
- package/docs/reference/reload.md +107 -0
- package/docs/reference/texture-arrays.md +113 -0
- package/docs/reference/texture-pipeline.md +53 -0
- package/docs/roadmap.md +104 -0
- package/format-notices/black/LICENSE +21 -21
- package/format-notices/black/NOTICE +47 -47
- package/format-notices/bnk/LICENSE +21 -21
- package/format-notices/bnk/NOTICE +20 -20
- package/format-notices/cmf/LICENSE +21 -21
- package/format-notices/cmf/NOTICE +36 -36
- package/format-notices/dds/LICENSE +21 -21
- package/format-notices/dds/NOTICE +14 -14
- package/format-notices/fbx/LICENSE +21 -21
- package/format-notices/fbx/NOTICE +14 -14
- package/format-notices/flac/LICENSE +21 -21
- package/format-notices/flac/NOTICE +14 -14
- package/format-notices/gif/LICENSE +21 -21
- package/format-notices/gif/NOTICE +14 -14
- package/format-notices/gltf/LICENSE +21 -21
- package/format-notices/gltf/NOTICE +27 -27
- package/format-notices/gr2/LICENSE +21 -0
- package/format-notices/gr2/NOTICE +60 -0
- package/format-notices/gr2/THIRD-PARTY-NOTICES.md +93 -0
- package/format-notices/jpeg/LICENSE +21 -21
- package/format-notices/jpeg/NOTICE +14 -14
- package/format-notices/mp3/LICENSE +21 -21
- package/format-notices/mp3/NOTICE +14 -14
- package/format-notices/mp4/LICENSE +21 -21
- package/format-notices/mp4/NOTICE +14 -14
- package/format-notices/obj/LICENSE +21 -21
- package/format-notices/obj/NOTICE +26 -26
- package/format-notices/ogg/LICENSE +21 -21
- package/format-notices/ogg/NOTICE +28 -28
- package/format-notices/png/LICENSE +21 -21
- package/format-notices/png/NOTICE +14 -14
- package/format-notices/red/LICENSE +21 -21
- package/format-notices/red/NOTICE +31 -31
- package/format-notices/stl/LICENSE +21 -21
- package/format-notices/stl/NOTICE +21 -21
- package/format-notices/tga/LICENSE +21 -21
- package/format-notices/tga/NOTICE +14 -14
- package/format-notices/wav/LICENSE +21 -21
- package/format-notices/wav/NOTICE +14 -14
- package/format-notices/webm/LICENSE +21 -21
- package/format-notices/webm/NOTICE +14 -14
- package/format-notices/webp/LICENSE +21 -21
- package/format-notices/webp/NOTICE +14 -14
- package/format-notices/wem/LICENSE +57 -57
- package/format-notices/wem/NOTICE +33 -33
- package/format-notices/yaml/LICENSE +21 -21
- package/format-notices/yaml/NOTICE +44 -44
- package/package.json +52 -51
- package/resource-lifecycle.md +0 -679
|
@@ -1,261 +1,261 @@
|
|
|
1
|
-
import { hydrateJson } from './json.js';
|
|
2
|
-
import { CMF_CLASS_KEYS, hydrateCmf, buildCmfFromShared } from './targets.js';
|
|
3
|
-
import { parseStl, trianglesToJson, jsonToTriangles, inspectTriangles, writeBinaryStl, writeAsciiStl, trianglesFromInput } from './stl.js';
|
|
4
|
-
export { isBinaryStl, isStl, toText } from './stl.js';
|
|
5
|
-
|
|
6
|
-
/**
|
|
7
|
-
* Internal pipeline glue for CjsStlFormat.
|
|
8
|
-
*/
|
|
9
|
-
|
|
10
|
-
const GR2_CLASS_KEYS = Object.freeze(["Root", "Mesh", "BoneBinding", "IndexGroup", "MorphTarget", "Model", "Skeleton", "Bone", "Animation", "TrackGroup", "TransformTrack", "Curve"]);
|
|
11
|
-
const CLASS_KEYS = Object.freeze(Array.from(new Set([...GR2_CLASS_KEYS, ...CMF_CLASS_KEYS])));
|
|
12
|
-
const OUTPUT_JSON = "json";
|
|
13
|
-
const OUTPUT_STL_JSON = "stlJson";
|
|
14
|
-
const OUTPUT_SHARED = "shared";
|
|
15
|
-
const OUTPUT_GR2 = "gr2";
|
|
16
|
-
const OUTPUT_CMF = "cmf";
|
|
17
|
-
const DEFAULT_VALUES = Object.freeze({
|
|
18
|
-
emit: OUTPUT_STL_JSON,
|
|
19
|
-
source: "memory",
|
|
20
|
-
binary: true,
|
|
21
|
-
solidName: "carbonenginejs",
|
|
22
|
-
scale: 1,
|
|
23
|
-
recalculateNormals: true,
|
|
24
|
-
weldVertices: false,
|
|
25
|
-
weldTolerance: 1e-5,
|
|
26
|
-
skipDegenerate: true,
|
|
27
|
-
requireWatertight: false,
|
|
28
|
-
classes: Object.freeze({})
|
|
29
|
-
});
|
|
30
|
-
const OPTION_KEYS = new Set(["emit", "source", "binary", "solidName", "scale", "recalculateNormals", "weldVertices", "weldTolerance", "skipDegenerate", "requireWatertight", "classes"]);
|
|
31
|
-
function validateBoolean(name, value, readerName) {
|
|
32
|
-
if (typeof value === "boolean") return value;
|
|
33
|
-
throw new TypeError(`${readerName}: ${name} must be true or false`);
|
|
34
|
-
}
|
|
35
|
-
function validateNumber(name, value, readerName, {
|
|
36
|
-
minExclusive = null,
|
|
37
|
-
minInclusive = null
|
|
38
|
-
} = {}) {
|
|
39
|
-
if (typeof value !== "number" || !Number.isFinite(value)) {
|
|
40
|
-
throw new TypeError(`${readerName}: ${name} must be a finite number`);
|
|
41
|
-
}
|
|
42
|
-
if (minExclusive !== null && value <= minExclusive) {
|
|
43
|
-
throw new TypeError(`${readerName}: ${name} must be greater than ${minExclusive}`);
|
|
44
|
-
}
|
|
45
|
-
if (minInclusive !== null && value < minInclusive) {
|
|
46
|
-
throw new TypeError(`${readerName}: ${name} must be at least ${minInclusive}`);
|
|
47
|
-
}
|
|
48
|
-
return value;
|
|
49
|
-
}
|
|
50
|
-
|
|
51
|
-
/**
|
|
52
|
-
* Validate a `classes` node key against {@link CLASS_KEYS}.
|
|
53
|
-
*
|
|
54
|
-
* @param {string} key Candidate node key.
|
|
55
|
-
* @param {string} [readerName] Format name used in thrown errors.
|
|
56
|
-
*/
|
|
57
|
-
function validateClassKey(key, readerName = "CjsStlFormat") {
|
|
58
|
-
if (!CLASS_KEYS.includes(key)) {
|
|
59
|
-
throw new Error(`${readerName}: unknown class key ${JSON.stringify(key)}; expected one of ${CLASS_KEYS.join(", ")}`);
|
|
60
|
-
}
|
|
61
|
-
}
|
|
62
|
-
|
|
63
|
-
/**
|
|
64
|
-
* Validate a single `classes` entry.
|
|
65
|
-
*
|
|
66
|
-
* @param {string} key Node key.
|
|
67
|
-
* @param {Function} Class Candidate constructor.
|
|
68
|
-
* @param {string} [readerName] Format name used in thrown errors.
|
|
69
|
-
*/
|
|
70
|
-
function validateClass(key, Class, readerName = "CjsStlFormat") {
|
|
71
|
-
validateClassKey(key, readerName);
|
|
72
|
-
if (typeof Class !== "function") {
|
|
73
|
-
throw new TypeError(`${readerName}: class ${JSON.stringify(key)} must be a constructor`);
|
|
74
|
-
}
|
|
75
|
-
}
|
|
76
|
-
function mergeClasses(base, classes, readerName) {
|
|
77
|
-
if (!classes || typeof classes !== "object") {
|
|
78
|
-
throw new TypeError(`${readerName}: classes option must be an object`);
|
|
79
|
-
}
|
|
80
|
-
const next = {
|
|
81
|
-
...base
|
|
82
|
-
};
|
|
83
|
-
for (const [key, Class] of Object.entries(classes)) {
|
|
84
|
-
if (Class === null || Class === undefined) {
|
|
85
|
-
delete next[key];
|
|
86
|
-
continue;
|
|
87
|
-
}
|
|
88
|
-
validateClass(key, Class, readerName);
|
|
89
|
-
next[key] = Class;
|
|
90
|
-
}
|
|
91
|
-
return next;
|
|
92
|
-
}
|
|
93
|
-
function sanitizeName(value) {
|
|
94
|
-
if (typeof value !== "string" || !value.trim()) return DEFAULT_VALUES.solidName;
|
|
95
|
-
return value.trim();
|
|
96
|
-
}
|
|
97
|
-
|
|
98
|
-
/**
|
|
99
|
-
* Merge format values over a base set and validate them.
|
|
100
|
-
*
|
|
101
|
-
* @param {object} base Current values.
|
|
102
|
-
* @param {object} [options] Values to merge in.
|
|
103
|
-
* @param {string} [readerName] Format name used in error messages.
|
|
104
|
-
* @returns {object} A validated copy of the merged values.
|
|
105
|
-
*/
|
|
106
|
-
function normalizeValues(base, options = {}, readerName = "CjsStlFormat") {
|
|
107
|
-
if (!options || typeof options !== "object") {
|
|
108
|
-
throw new TypeError(`${readerName}: options must be an object`);
|
|
109
|
-
}
|
|
110
|
-
for (const key of Object.keys(options)) {
|
|
111
|
-
if (!OPTION_KEYS.has(key)) {
|
|
112
|
-
throw new TypeError(`${readerName}: unknown option ${JSON.stringify(key)}`);
|
|
113
|
-
}
|
|
114
|
-
}
|
|
115
|
-
const values = {
|
|
116
|
-
...base,
|
|
117
|
-
...options
|
|
118
|
-
};
|
|
119
|
-
const emit = normalizeEmit(values.emit, readerName);
|
|
120
|
-
const classes = Object.prototype.hasOwnProperty.call(options, "classes") ? mergeClasses(base.classes || {}, options.classes, readerName) : {
|
|
121
|
-
...(base.classes || {})
|
|
122
|
-
};
|
|
123
|
-
if ((emit === OUTPUT_GR2 || emit === OUTPUT_CMF) && !hasClasses(classes)) {
|
|
124
|
-
throw new TypeError(`${readerName}: emit "${emit}" requires explicit classes`);
|
|
125
|
-
}
|
|
126
|
-
if (typeof values.source !== "string" || !values.source) {
|
|
127
|
-
values.source = DEFAULT_VALUES.source;
|
|
128
|
-
}
|
|
129
|
-
return {
|
|
130
|
-
emit,
|
|
131
|
-
source: values.source,
|
|
132
|
-
binary: validateBoolean("binary", values.binary, readerName),
|
|
133
|
-
solidName: sanitizeName(values.solidName),
|
|
134
|
-
scale: validateNumber("scale", values.scale, readerName, {
|
|
135
|
-
minExclusive: 0
|
|
136
|
-
}),
|
|
137
|
-
recalculateNormals: validateBoolean("recalculateNormals", values.recalculateNormals, readerName),
|
|
138
|
-
weldVertices: validateBoolean("weldVertices", values.weldVertices, readerName),
|
|
139
|
-
weldTolerance: validateNumber("weldTolerance", values.weldTolerance, readerName, {
|
|
140
|
-
minInclusive: 0
|
|
141
|
-
}),
|
|
142
|
-
skipDegenerate: validateBoolean("skipDegenerate", values.skipDegenerate, readerName),
|
|
143
|
-
requireWatertight: validateBoolean("requireWatertight", values.requireWatertight, readerName),
|
|
144
|
-
classes
|
|
145
|
-
};
|
|
146
|
-
}
|
|
147
|
-
function normalizeEmit(emit, readerName) {
|
|
148
|
-
if (emit === undefined || emit === null || emit === OUTPUT_JSON || emit === OUTPUT_STL_JSON || emit === OUTPUT_SHARED) {
|
|
149
|
-
return OUTPUT_STL_JSON;
|
|
150
|
-
}
|
|
151
|
-
if (emit === OUTPUT_GR2 || emit === OUTPUT_CMF) return emit;
|
|
152
|
-
throw new TypeError(`${readerName}: emit must be "${OUTPUT_SHARED}", "${OUTPUT_STL_JSON}", "${OUTPUT_GR2}", or "${OUTPUT_CMF}", got ${JSON.stringify(emit)}`);
|
|
153
|
-
}
|
|
154
|
-
function hasClasses(classes) {
|
|
155
|
-
return !!classes && Object.values(classes).some(Class => typeof Class === "function");
|
|
156
|
-
}
|
|
157
|
-
|
|
158
|
-
/**
|
|
159
|
-
* Read STL text/bytes and return the shared JSON schema.
|
|
160
|
-
*
|
|
161
|
-
* @param {object|Function} format Format instance or constructor.
|
|
162
|
-
* @param {string|Uint8Array|ArrayBuffer|DataView} input STL text or bytes.
|
|
163
|
-
* @param {object} values Normalized format values.
|
|
164
|
-
* @returns {object} Shared JSON graph.
|
|
165
|
-
*/
|
|
166
|
-
function readWithValues(format, input, values) {
|
|
167
|
-
const parsed = parseStl(input);
|
|
168
|
-
const json = trianglesToJson(parsed.triangles, values, parsed);
|
|
169
|
-
if (values.emit === OUTPUT_CMF) return hydrateCmf(buildCmfFromShared(json), values.classes, {
|
|
170
|
-
source: values.source
|
|
171
|
-
});
|
|
172
|
-
return hydrateJson(json, {
|
|
173
|
-
classes: values.classes,
|
|
174
|
-
source: values.source
|
|
175
|
-
});
|
|
176
|
-
}
|
|
177
|
-
|
|
178
|
-
/**
|
|
179
|
-
* Write the shared JSON geometry schema to STL.
|
|
180
|
-
* The input is read-only. Meshes and index groups are flattened by
|
|
181
|
-
* {@link jsonToTriangles}; optional topology enforcement runs against that
|
|
182
|
-
* exact scaled triangle stream before encoding begins.
|
|
183
|
-
*
|
|
184
|
-
* @param {object} input Shared JSON root or mesh.
|
|
185
|
-
* @param {object} values Normalized format values.
|
|
186
|
-
* @returns {string|Uint8Array} ASCII STL text or binary STL bytes.
|
|
187
|
-
* @throws {TypeError|RangeError|Error} If geometry, numeric values, indices, topology, or binary range are invalid.
|
|
188
|
-
*/
|
|
189
|
-
function writeWithValues(input, values) {
|
|
190
|
-
const triangles = jsonToTriangles(input, values);
|
|
191
|
-
if (!triangles.length) {
|
|
192
|
-
throw new Error("CjsStlFormat: write input did not produce any triangles");
|
|
193
|
-
}
|
|
194
|
-
if (values.requireWatertight) {
|
|
195
|
-
const report = inspectTriangles(triangles, values, {
|
|
196
|
-
format: "json",
|
|
197
|
-
source: input.grannyFileSource || values.source
|
|
198
|
-
});
|
|
199
|
-
if (!report.printable) {
|
|
200
|
-
throw new Error(`CjsStlFormat: requireWatertight failed (${report.issues.map(issue => issue.key).join(", ")})`);
|
|
201
|
-
}
|
|
202
|
-
}
|
|
203
|
-
return values.binary ? writeBinaryStl(triangles, values.solidName) : writeAsciiStl(triangles, values.solidName);
|
|
204
|
-
}
|
|
205
|
-
|
|
206
|
-
/**
|
|
207
|
-
* Inspect STL or shared JSON geometry without class hydration.
|
|
208
|
-
*
|
|
209
|
-
* @param {any} input STL text/bytes or shared JSON.
|
|
210
|
-
* @param {object} values Normalized format values.
|
|
211
|
-
* @returns {object} Plain printability report.
|
|
212
|
-
*/
|
|
213
|
-
function inspectWithValues(input, values) {
|
|
214
|
-
const source = trianglesFromInput(input, values);
|
|
215
|
-
return inspectTriangles(source.triangles, values, source);
|
|
216
|
-
}
|
|
217
|
-
|
|
218
|
-
/**
|
|
219
|
-
* Convert format output to plain JSON-compatible data.
|
|
220
|
-
*
|
|
221
|
-
* @param {any} value Format output.
|
|
222
|
-
* @returns {any} JSON-compatible value.
|
|
223
|
-
*/
|
|
224
|
-
function toJsonValue(value) {
|
|
225
|
-
if (value === null || value === undefined) return value;
|
|
226
|
-
if (typeof value !== "object") return value;
|
|
227
|
-
if (typeof value.toJSON === "function") {
|
|
228
|
-
const next = value.toJSON();
|
|
229
|
-
if (next !== value) return toJsonValue(next);
|
|
230
|
-
}
|
|
231
|
-
if (Array.isArray(value)) return value.map(toJsonValue);
|
|
232
|
-
if (ArrayBuffer.isView(value) && !(value instanceof DataView)) return Array.from(value);
|
|
233
|
-
const out = {};
|
|
234
|
-
for (const key of Object.keys(value)) {
|
|
235
|
-
out[key] = toJsonValue(value[key]);
|
|
236
|
-
}
|
|
237
|
-
return out;
|
|
238
|
-
}
|
|
239
|
-
|
|
240
|
-
/**
|
|
241
|
-
* Imports a Node built-in module without exposing the specifier to any
|
|
242
|
-
* bundler's static import graph.
|
|
243
|
-
*
|
|
244
|
-
* `await import("node:fs/promises")` written as a literal is resolved
|
|
245
|
-
* eagerly by webpack/Rollup/esbuild alike when they walk the module
|
|
246
|
-
* graph, breaking browser builds even though this path only ever runs
|
|
247
|
-
* under Node (readFile/writeFile are Node-only conveniences). Building
|
|
248
|
-
* the specifier inside a `Function` body hides it from every bundler's
|
|
249
|
-
* static analysis - it only exists at runtime, in the Node process that
|
|
250
|
-
* actually calls readFile/writeFile.
|
|
251
|
-
*
|
|
252
|
-
* @param {string} specifier Node built-in module specifier, e.g. "node:fs/promises".
|
|
253
|
-
* @returns {Promise<any>} The imported module namespace.
|
|
254
|
-
*/
|
|
255
|
-
function importNodeModule(specifier) {
|
|
256
|
-
// eslint-disable-next-line no-new-func
|
|
257
|
-
return new Function("s", "return import(s)")(specifier);
|
|
258
|
-
}
|
|
259
|
-
|
|
260
|
-
export { CLASS_KEYS, DEFAULT_VALUES, GR2_CLASS_KEYS, OUTPUT_CMF, OUTPUT_GR2, OUTPUT_JSON, OUTPUT_SHARED, OUTPUT_STL_JSON, importNodeModule, inspectWithValues, normalizeValues, readWithValues, toJsonValue, validateClass, validateClassKey, writeWithValues };
|
|
261
|
-
//# sourceMappingURL=helpers.js.map
|
|
1
|
+
import { hydrateJson } from './json.js';
|
|
2
|
+
import { CMF_CLASS_KEYS, hydrateCmf, buildCmfFromShared } from './targets.js';
|
|
3
|
+
import { parseStl, trianglesToJson, jsonToTriangles, inspectTriangles, writeBinaryStl, writeAsciiStl, trianglesFromInput } from './stl.js';
|
|
4
|
+
export { isBinaryStl, isStl, toText } from './stl.js';
|
|
5
|
+
|
|
6
|
+
/**
|
|
7
|
+
* Internal pipeline glue for CjsStlFormat.
|
|
8
|
+
*/
|
|
9
|
+
|
|
10
|
+
const GR2_CLASS_KEYS = Object.freeze(["Root", "Mesh", "BoneBinding", "IndexGroup", "MorphTarget", "Model", "Skeleton", "Bone", "Animation", "TrackGroup", "TransformTrack", "Curve"]);
|
|
11
|
+
const CLASS_KEYS = Object.freeze(Array.from(new Set([...GR2_CLASS_KEYS, ...CMF_CLASS_KEYS])));
|
|
12
|
+
const OUTPUT_JSON = "json";
|
|
13
|
+
const OUTPUT_STL_JSON = "stlJson";
|
|
14
|
+
const OUTPUT_SHARED = "shared";
|
|
15
|
+
const OUTPUT_GR2 = "gr2";
|
|
16
|
+
const OUTPUT_CMF = "cmf";
|
|
17
|
+
const DEFAULT_VALUES = Object.freeze({
|
|
18
|
+
emit: OUTPUT_STL_JSON,
|
|
19
|
+
source: "memory",
|
|
20
|
+
binary: true,
|
|
21
|
+
solidName: "carbonenginejs",
|
|
22
|
+
scale: 1,
|
|
23
|
+
recalculateNormals: true,
|
|
24
|
+
weldVertices: false,
|
|
25
|
+
weldTolerance: 1e-5,
|
|
26
|
+
skipDegenerate: true,
|
|
27
|
+
requireWatertight: false,
|
|
28
|
+
classes: Object.freeze({})
|
|
29
|
+
});
|
|
30
|
+
const OPTION_KEYS = new Set(["emit", "source", "binary", "solidName", "scale", "recalculateNormals", "weldVertices", "weldTolerance", "skipDegenerate", "requireWatertight", "classes"]);
|
|
31
|
+
function validateBoolean(name, value, readerName) {
|
|
32
|
+
if (typeof value === "boolean") return value;
|
|
33
|
+
throw new TypeError(`${readerName}: ${name} must be true or false`);
|
|
34
|
+
}
|
|
35
|
+
function validateNumber(name, value, readerName, {
|
|
36
|
+
minExclusive = null,
|
|
37
|
+
minInclusive = null
|
|
38
|
+
} = {}) {
|
|
39
|
+
if (typeof value !== "number" || !Number.isFinite(value)) {
|
|
40
|
+
throw new TypeError(`${readerName}: ${name} must be a finite number`);
|
|
41
|
+
}
|
|
42
|
+
if (minExclusive !== null && value <= minExclusive) {
|
|
43
|
+
throw new TypeError(`${readerName}: ${name} must be greater than ${minExclusive}`);
|
|
44
|
+
}
|
|
45
|
+
if (minInclusive !== null && value < minInclusive) {
|
|
46
|
+
throw new TypeError(`${readerName}: ${name} must be at least ${minInclusive}`);
|
|
47
|
+
}
|
|
48
|
+
return value;
|
|
49
|
+
}
|
|
50
|
+
|
|
51
|
+
/**
|
|
52
|
+
* Validate a `classes` node key against {@link CLASS_KEYS}.
|
|
53
|
+
*
|
|
54
|
+
* @param {string} key Candidate node key.
|
|
55
|
+
* @param {string} [readerName] Format name used in thrown errors.
|
|
56
|
+
*/
|
|
57
|
+
function validateClassKey(key, readerName = "CjsStlFormat") {
|
|
58
|
+
if (!CLASS_KEYS.includes(key)) {
|
|
59
|
+
throw new Error(`${readerName}: unknown class key ${JSON.stringify(key)}; expected one of ${CLASS_KEYS.join(", ")}`);
|
|
60
|
+
}
|
|
61
|
+
}
|
|
62
|
+
|
|
63
|
+
/**
|
|
64
|
+
* Validate a single `classes` entry.
|
|
65
|
+
*
|
|
66
|
+
* @param {string} key Node key.
|
|
67
|
+
* @param {Function} Class Candidate constructor.
|
|
68
|
+
* @param {string} [readerName] Format name used in thrown errors.
|
|
69
|
+
*/
|
|
70
|
+
function validateClass(key, Class, readerName = "CjsStlFormat") {
|
|
71
|
+
validateClassKey(key, readerName);
|
|
72
|
+
if (typeof Class !== "function") {
|
|
73
|
+
throw new TypeError(`${readerName}: class ${JSON.stringify(key)} must be a constructor`);
|
|
74
|
+
}
|
|
75
|
+
}
|
|
76
|
+
function mergeClasses(base, classes, readerName) {
|
|
77
|
+
if (!classes || typeof classes !== "object") {
|
|
78
|
+
throw new TypeError(`${readerName}: classes option must be an object`);
|
|
79
|
+
}
|
|
80
|
+
const next = {
|
|
81
|
+
...base
|
|
82
|
+
};
|
|
83
|
+
for (const [key, Class] of Object.entries(classes)) {
|
|
84
|
+
if (Class === null || Class === undefined) {
|
|
85
|
+
delete next[key];
|
|
86
|
+
continue;
|
|
87
|
+
}
|
|
88
|
+
validateClass(key, Class, readerName);
|
|
89
|
+
next[key] = Class;
|
|
90
|
+
}
|
|
91
|
+
return next;
|
|
92
|
+
}
|
|
93
|
+
function sanitizeName(value) {
|
|
94
|
+
if (typeof value !== "string" || !value.trim()) return DEFAULT_VALUES.solidName;
|
|
95
|
+
return value.trim();
|
|
96
|
+
}
|
|
97
|
+
|
|
98
|
+
/**
|
|
99
|
+
* Merge format values over a base set and validate them.
|
|
100
|
+
*
|
|
101
|
+
* @param {object} base Current values.
|
|
102
|
+
* @param {object} [options] Values to merge in.
|
|
103
|
+
* @param {string} [readerName] Format name used in error messages.
|
|
104
|
+
* @returns {object} A validated copy of the merged values.
|
|
105
|
+
*/
|
|
106
|
+
function normalizeValues(base, options = {}, readerName = "CjsStlFormat") {
|
|
107
|
+
if (!options || typeof options !== "object") {
|
|
108
|
+
throw new TypeError(`${readerName}: options must be an object`);
|
|
109
|
+
}
|
|
110
|
+
for (const key of Object.keys(options)) {
|
|
111
|
+
if (!OPTION_KEYS.has(key)) {
|
|
112
|
+
throw new TypeError(`${readerName}: unknown option ${JSON.stringify(key)}`);
|
|
113
|
+
}
|
|
114
|
+
}
|
|
115
|
+
const values = {
|
|
116
|
+
...base,
|
|
117
|
+
...options
|
|
118
|
+
};
|
|
119
|
+
const emit = normalizeEmit(values.emit, readerName);
|
|
120
|
+
const classes = Object.prototype.hasOwnProperty.call(options, "classes") ? mergeClasses(base.classes || {}, options.classes, readerName) : {
|
|
121
|
+
...(base.classes || {})
|
|
122
|
+
};
|
|
123
|
+
if ((emit === OUTPUT_GR2 || emit === OUTPUT_CMF) && !hasClasses(classes)) {
|
|
124
|
+
throw new TypeError(`${readerName}: emit "${emit}" requires explicit classes`);
|
|
125
|
+
}
|
|
126
|
+
if (typeof values.source !== "string" || !values.source) {
|
|
127
|
+
values.source = DEFAULT_VALUES.source;
|
|
128
|
+
}
|
|
129
|
+
return {
|
|
130
|
+
emit,
|
|
131
|
+
source: values.source,
|
|
132
|
+
binary: validateBoolean("binary", values.binary, readerName),
|
|
133
|
+
solidName: sanitizeName(values.solidName),
|
|
134
|
+
scale: validateNumber("scale", values.scale, readerName, {
|
|
135
|
+
minExclusive: 0
|
|
136
|
+
}),
|
|
137
|
+
recalculateNormals: validateBoolean("recalculateNormals", values.recalculateNormals, readerName),
|
|
138
|
+
weldVertices: validateBoolean("weldVertices", values.weldVertices, readerName),
|
|
139
|
+
weldTolerance: validateNumber("weldTolerance", values.weldTolerance, readerName, {
|
|
140
|
+
minInclusive: 0
|
|
141
|
+
}),
|
|
142
|
+
skipDegenerate: validateBoolean("skipDegenerate", values.skipDegenerate, readerName),
|
|
143
|
+
requireWatertight: validateBoolean("requireWatertight", values.requireWatertight, readerName),
|
|
144
|
+
classes
|
|
145
|
+
};
|
|
146
|
+
}
|
|
147
|
+
function normalizeEmit(emit, readerName) {
|
|
148
|
+
if (emit === undefined || emit === null || emit === OUTPUT_JSON || emit === OUTPUT_STL_JSON || emit === OUTPUT_SHARED) {
|
|
149
|
+
return OUTPUT_STL_JSON;
|
|
150
|
+
}
|
|
151
|
+
if (emit === OUTPUT_GR2 || emit === OUTPUT_CMF) return emit;
|
|
152
|
+
throw new TypeError(`${readerName}: emit must be "${OUTPUT_SHARED}", "${OUTPUT_STL_JSON}", "${OUTPUT_GR2}", or "${OUTPUT_CMF}", got ${JSON.stringify(emit)}`);
|
|
153
|
+
}
|
|
154
|
+
function hasClasses(classes) {
|
|
155
|
+
return !!classes && Object.values(classes).some(Class => typeof Class === "function");
|
|
156
|
+
}
|
|
157
|
+
|
|
158
|
+
/**
|
|
159
|
+
* Read STL text/bytes and return the shared JSON schema.
|
|
160
|
+
*
|
|
161
|
+
* @param {object|Function} format Format instance or constructor.
|
|
162
|
+
* @param {string|Uint8Array|ArrayBuffer|DataView} input STL text or bytes.
|
|
163
|
+
* @param {object} values Normalized format values.
|
|
164
|
+
* @returns {object} Shared JSON graph.
|
|
165
|
+
*/
|
|
166
|
+
function readWithValues(format, input, values) {
|
|
167
|
+
const parsed = parseStl(input);
|
|
168
|
+
const json = trianglesToJson(parsed.triangles, values, parsed);
|
|
169
|
+
if (values.emit === OUTPUT_CMF) return hydrateCmf(buildCmfFromShared(json), values.classes, {
|
|
170
|
+
source: values.source
|
|
171
|
+
});
|
|
172
|
+
return hydrateJson(json, {
|
|
173
|
+
classes: values.classes,
|
|
174
|
+
source: values.source
|
|
175
|
+
});
|
|
176
|
+
}
|
|
177
|
+
|
|
178
|
+
/**
|
|
179
|
+
* Write the shared JSON geometry schema to STL.
|
|
180
|
+
* The input is read-only. Meshes and index groups are flattened by
|
|
181
|
+
* {@link jsonToTriangles}; optional topology enforcement runs against that
|
|
182
|
+
* exact scaled triangle stream before encoding begins.
|
|
183
|
+
*
|
|
184
|
+
* @param {object} input Shared JSON root or mesh.
|
|
185
|
+
* @param {object} values Normalized format values.
|
|
186
|
+
* @returns {string|Uint8Array} ASCII STL text or binary STL bytes.
|
|
187
|
+
* @throws {TypeError|RangeError|Error} If geometry, numeric values, indices, topology, or binary range are invalid.
|
|
188
|
+
*/
|
|
189
|
+
function writeWithValues(input, values) {
|
|
190
|
+
const triangles = jsonToTriangles(input, values);
|
|
191
|
+
if (!triangles.length) {
|
|
192
|
+
throw new Error("CjsStlFormat: write input did not produce any triangles");
|
|
193
|
+
}
|
|
194
|
+
if (values.requireWatertight) {
|
|
195
|
+
const report = inspectTriangles(triangles, values, {
|
|
196
|
+
format: "json",
|
|
197
|
+
source: input.grannyFileSource || values.source
|
|
198
|
+
});
|
|
199
|
+
if (!report.printable) {
|
|
200
|
+
throw new Error(`CjsStlFormat: requireWatertight failed (${report.issues.map(issue => issue.key).join(", ")})`);
|
|
201
|
+
}
|
|
202
|
+
}
|
|
203
|
+
return values.binary ? writeBinaryStl(triangles, values.solidName) : writeAsciiStl(triangles, values.solidName);
|
|
204
|
+
}
|
|
205
|
+
|
|
206
|
+
/**
|
|
207
|
+
* Inspect STL or shared JSON geometry without class hydration.
|
|
208
|
+
*
|
|
209
|
+
* @param {any} input STL text/bytes or shared JSON.
|
|
210
|
+
* @param {object} values Normalized format values.
|
|
211
|
+
* @returns {object} Plain printability report.
|
|
212
|
+
*/
|
|
213
|
+
function inspectWithValues(input, values) {
|
|
214
|
+
const source = trianglesFromInput(input, values);
|
|
215
|
+
return inspectTriangles(source.triangles, values, source);
|
|
216
|
+
}
|
|
217
|
+
|
|
218
|
+
/**
|
|
219
|
+
* Convert format output to plain JSON-compatible data.
|
|
220
|
+
*
|
|
221
|
+
* @param {any} value Format output.
|
|
222
|
+
* @returns {any} JSON-compatible value.
|
|
223
|
+
*/
|
|
224
|
+
function toJsonValue(value) {
|
|
225
|
+
if (value === null || value === undefined) return value;
|
|
226
|
+
if (typeof value !== "object") return value;
|
|
227
|
+
if (typeof value.toJSON === "function") {
|
|
228
|
+
const next = value.toJSON();
|
|
229
|
+
if (next !== value) return toJsonValue(next);
|
|
230
|
+
}
|
|
231
|
+
if (Array.isArray(value)) return value.map(toJsonValue);
|
|
232
|
+
if (ArrayBuffer.isView(value) && !(value instanceof DataView)) return Array.from(value);
|
|
233
|
+
const out = {};
|
|
234
|
+
for (const key of Object.keys(value)) {
|
|
235
|
+
out[key] = toJsonValue(value[key]);
|
|
236
|
+
}
|
|
237
|
+
return out;
|
|
238
|
+
}
|
|
239
|
+
|
|
240
|
+
/**
|
|
241
|
+
* Imports a Node built-in module without exposing the specifier to any
|
|
242
|
+
* bundler's static import graph.
|
|
243
|
+
*
|
|
244
|
+
* `await import("node:fs/promises")` written as a literal is resolved
|
|
245
|
+
* eagerly by webpack/Rollup/esbuild alike when they walk the module
|
|
246
|
+
* graph, breaking browser builds even though this path only ever runs
|
|
247
|
+
* under Node (readFile/writeFile are Node-only conveniences). Building
|
|
248
|
+
* the specifier inside a `Function` body hides it from every bundler's
|
|
249
|
+
* static analysis - it only exists at runtime, in the Node process that
|
|
250
|
+
* actually calls readFile/writeFile.
|
|
251
|
+
*
|
|
252
|
+
* @param {string} specifier Node built-in module specifier, e.g. "node:fs/promises".
|
|
253
|
+
* @returns {Promise<any>} The imported module namespace.
|
|
254
|
+
*/
|
|
255
|
+
function importNodeModule(specifier) {
|
|
256
|
+
// eslint-disable-next-line no-new-func
|
|
257
|
+
return new Function("s", "return import(s)")(specifier);
|
|
258
|
+
}
|
|
259
|
+
|
|
260
|
+
export { CLASS_KEYS, DEFAULT_VALUES, GR2_CLASS_KEYS, OUTPUT_CMF, OUTPUT_GR2, OUTPUT_JSON, OUTPUT_SHARED, OUTPUT_STL_JSON, importNodeModule, inspectWithValues, normalizeValues, readWithValues, toJsonValue, validateClass, validateClassKey, writeWithValues };
|
|
261
|
+
//# sourceMappingURL=helpers.js.map
|
|
@@ -1,51 +1,51 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* JSON hydration helpers for the shared CarbonEngineJS mesh schema.
|
|
3
|
-
*/
|
|
4
|
-
|
|
5
|
-
function build(classes, key, props, hydrationOptions = {}) {
|
|
6
|
-
const Ctor = classes[key];
|
|
7
|
-
return Ctor ? populate(new Ctor(), props, hydrationOptions) : props;
|
|
8
|
-
}
|
|
9
|
-
function populate(instance, props, hydrationOptions = {}) {
|
|
10
|
-
if (!instance || typeof instance.SetValues !== "function") {
|
|
11
|
-
throw new TypeError("CjsStlFormat class population requires classes to implement SetValues(values)");
|
|
12
|
-
}
|
|
13
|
-
instance.SetValues(props, {
|
|
14
|
-
...hydrationOptions,
|
|
15
|
-
skipUpdate: true,
|
|
16
|
-
skipEvents: true
|
|
17
|
-
});
|
|
18
|
-
return instance;
|
|
19
|
-
}
|
|
20
|
-
|
|
21
|
-
/**
|
|
22
|
-
* Hydrate the plain shared JSON schema with caller-supplied classes.
|
|
23
|
-
*
|
|
24
|
-
* @param {object} root Plain JSON graph.
|
|
25
|
-
* @param {object} [options] Hydration options.
|
|
26
|
-
* @param {object} [options.classes] Node constructor map.
|
|
27
|
-
* @returns {object} Hydrated graph.
|
|
28
|
-
*/
|
|
29
|
-
function hydrateJson(root, {
|
|
30
|
-
classes = {},
|
|
31
|
-
...hydrationOptions
|
|
32
|
-
} = {}) {
|
|
33
|
-
return build(classes, "Root", {
|
|
34
|
-
grannyFileFormatRevision: root.grannyFileFormatRevision,
|
|
35
|
-
grannyFileSource: root.grannyFileSource,
|
|
36
|
-
meshes: root.meshes.map(mesh => build(classes, "Mesh", {
|
|
37
|
-
name: mesh.name,
|
|
38
|
-
morphTargets: mesh.morphTargets,
|
|
39
|
-
minBounds: mesh.minBounds,
|
|
40
|
-
maxBounds: mesh.maxBounds,
|
|
41
|
-
boneBindings: mesh.boneBindings,
|
|
42
|
-
vertex: mesh.vertex,
|
|
43
|
-
indices: mesh.indices.map(group => build(classes, "IndexGroup", group, hydrationOptions))
|
|
44
|
-
}, hydrationOptions)),
|
|
45
|
-
models: root.models,
|
|
46
|
-
animations: root.animations
|
|
47
|
-
}, hydrationOptions);
|
|
48
|
-
}
|
|
49
|
-
|
|
50
|
-
export { hydrateJson };
|
|
51
|
-
//# sourceMappingURL=json.js.map
|
|
1
|
+
/**
|
|
2
|
+
* JSON hydration helpers for the shared CarbonEngineJS mesh schema.
|
|
3
|
+
*/
|
|
4
|
+
|
|
5
|
+
function build(classes, key, props, hydrationOptions = {}) {
|
|
6
|
+
const Ctor = classes[key];
|
|
7
|
+
return Ctor ? populate(new Ctor(), props, hydrationOptions) : props;
|
|
8
|
+
}
|
|
9
|
+
function populate(instance, props, hydrationOptions = {}) {
|
|
10
|
+
if (!instance || typeof instance.SetValues !== "function") {
|
|
11
|
+
throw new TypeError("CjsStlFormat class population requires classes to implement SetValues(values)");
|
|
12
|
+
}
|
|
13
|
+
instance.SetValues(props, {
|
|
14
|
+
...hydrationOptions,
|
|
15
|
+
skipUpdate: true,
|
|
16
|
+
skipEvents: true
|
|
17
|
+
});
|
|
18
|
+
return instance;
|
|
19
|
+
}
|
|
20
|
+
|
|
21
|
+
/**
|
|
22
|
+
* Hydrate the plain shared JSON schema with caller-supplied classes.
|
|
23
|
+
*
|
|
24
|
+
* @param {object} root Plain JSON graph.
|
|
25
|
+
* @param {object} [options] Hydration options.
|
|
26
|
+
* @param {object} [options.classes] Node constructor map.
|
|
27
|
+
* @returns {object} Hydrated graph.
|
|
28
|
+
*/
|
|
29
|
+
function hydrateJson(root, {
|
|
30
|
+
classes = {},
|
|
31
|
+
...hydrationOptions
|
|
32
|
+
} = {}) {
|
|
33
|
+
return build(classes, "Root", {
|
|
34
|
+
grannyFileFormatRevision: root.grannyFileFormatRevision,
|
|
35
|
+
grannyFileSource: root.grannyFileSource,
|
|
36
|
+
meshes: root.meshes.map(mesh => build(classes, "Mesh", {
|
|
37
|
+
name: mesh.name,
|
|
38
|
+
morphTargets: mesh.morphTargets,
|
|
39
|
+
minBounds: mesh.minBounds,
|
|
40
|
+
maxBounds: mesh.maxBounds,
|
|
41
|
+
boneBindings: mesh.boneBindings,
|
|
42
|
+
vertex: mesh.vertex,
|
|
43
|
+
indices: mesh.indices.map(group => build(classes, "IndexGroup", group, hydrationOptions))
|
|
44
|
+
}, hydrationOptions)),
|
|
45
|
+
models: root.models,
|
|
46
|
+
animations: root.animations
|
|
47
|
+
}, hydrationOptions);
|
|
48
|
+
}
|
|
49
|
+
|
|
50
|
+
export { hydrateJson };
|
|
51
|
+
//# sourceMappingURL=json.js.map
|