reze-engine 0.3.11 → 0.3.13

package/dist/rzm-loader.js

@@ -0,0 +1,488 @@
+import { Model, } from "./model";
+import { Vec3, Mat4 } from "./math";
+/**
+ * RZM (Reze Model) Binary Format Loader
+ *
+ * Reads the RZM binary format and reconstructs a Model
+ */
+var SectionType;
+(function (SectionType) {
+    SectionType[SectionType["GEOMETRY"] = 1] = "GEOMETRY";
+    SectionType[SectionType["SKELETON"] = 2] = "SKELETON";
+    SectionType[SectionType["SKINNING"] = 3] = "SKINNING";
+    SectionType[SectionType["MORPHING"] = 4] = "MORPHING";
+    SectionType[SectionType["MATERIALS"] = 5] = "MATERIALS";
+    SectionType[SectionType["TEXTURES"] = 6] = "TEXTURES";
+    SectionType[SectionType["PHYSICS"] = 7] = "PHYSICS";
+})(SectionType || (SectionType = {}));
+export class RzmLoader {
+    constructor(buffer) {
+        this.offset = 0;
+        this.sections = new Map();
+        this.view = new DataView(buffer);
+    }
+    static async load(url) {
+        const response = await fetch(url);
+        const buffer = await response.arrayBuffer();
+        const loader = new RzmLoader(buffer);
+        return loader.parse();
+    }
+    static loadFromBuffer(buffer) {
+        const loader = new RzmLoader(buffer);
+        return loader.parse();
+    }
+    parse() {
+        this.parseHeader();
+        this.parseSectionTable();
+        // Parse all sections
+        const geometry = this.parseGeometry();
+        const skeleton = this.parseSkeleton();
+        const skinning = this.parseSkinning();
+        const morphing = this.parseMorphing();
+        const materials = this.parseMaterials();
+        const textures = this.parseTextures();
+        const physics = this.parsePhysics();
+        // Create new arrays with ArrayBuffer to satisfy type requirements
+        const vertexData = new Float32Array(geometry.vertexData.length);
+        vertexData.set(geometry.vertexData);
+        const indexData = new Uint32Array(geometry.indexData.length);
+        indexData.set(geometry.indexData);
+        return new Model(vertexData, indexData, textures, materials, skeleton, skinning, morphing, physics.rigidbodies, physics.joints);
+    }
+    parseHeader() {
+        // Read magic
+        const magic = String.fromCharCode(this.view.getUint8(0), this.view.getUint8(1), this.view.getUint8(2), this.view.getUint8(3));
+        if (magic !== RzmLoader.MAGIC) {
+            throw new Error(`Invalid RZM file: expected magic "${RzmLoader.MAGIC}", got "${magic}"`);
+        }
+        this.offset = 4;
+        const version = this.view.getUint32(this.offset, true);
+        if (version !== RzmLoader.VERSION) {
+            throw new Error(`Unsupported RZM version: ${version}, expected ${RzmLoader.VERSION}`);
+        }
+        this.offset += 4;
+        // Skip file size (uint64)
+        this.offset += 8;
+        // Skip section count (will be read from section table)
+        this.offset += 4;
+        // Skip reserved (16 bytes)
+        this.offset += 16;
+    }
+    parseSectionTable() {
+        const sectionCount = this.view.getUint32(12, true); // Section count is at offset 12
+        this.offset = RzmLoader.HEADER_SIZE;
+        for (let i = 0; i < sectionCount; i++) {
+            const type = this.view.getUint32(this.offset, true);
+            this.offset += 4;
+            const offset = Number(this.view.getBigUint64(this.offset, true));
+            this.offset += 8;
+            const size = Number(this.view.getBigUint64(this.offset, true));
+            this.offset += 8;
+            this.sections.set(type, { type, offset, size });
+        }
+    }
+    parseGeometry() {
+        const section = this.sections.get(SectionType.GEOMETRY);
+        if (!section)
+            throw new Error("Missing GEOMETRY section");
+        this.offset = section.offset;
+        const vertexCount = this.view.getUint32(this.offset, true);
+        this.offset += 4;
+        const vertexData = new Float32Array(this.view.buffer.slice(this.offset, this.offset + vertexCount * 8 * 4));
+        this.offset += vertexCount * 8 * 4;
+        const indexCount = this.view.getUint32(this.offset, true);
+        this.offset += 4;
+        const indexData = new Uint32Array(this.view.buffer.slice(this.offset, this.offset + indexCount * 4));
+        this.offset += indexCount * 4;
+        return { vertexData, indexData };
+    }
+    parseSkeleton() {
+        const section = this.sections.get(SectionType.SKELETON);
+        if (!section)
+            throw new Error("Missing SKELETON section");
+        this.offset = section.offset;
+        const boneCount = this.view.getUint32(this.offset, true);
+        this.offset += 4;
+        const bones = [];
+        for (let i = 0; i < boneCount; i++) {
+            const nameLen = this.view.getUint32(this.offset, true);
+            this.offset += 4;
+            const nameBytes = new Uint8Array(this.view.buffer, this.offset, nameLen);
+            const name = new TextDecoder().decode(nameBytes);
+            this.offset += nameLen;
+            const parentIndex = this.view.getInt32(this.offset, true);
+            this.offset += 4;
+            const bindTranslation = [
+                this.view.getFloat32(this.offset, true),
+                this.view.getFloat32(this.offset + 4, true),
+                this.view.getFloat32(this.offset + 8, true),
+            ];
+            this.offset += 12;
+            const appendParentIndex = this.view.getInt32(this.offset, true);
+            this.offset += 4;
+            const appendRatio = this.view.getFloat32(this.offset, true);
+            this.offset += 4;
+            const appendRotate = this.view.getUint8(this.offset) === 1;
+            this.offset += 1;
+            const appendMove = this.view.getUint8(this.offset) === 1;
+            this.offset += 1;
+            const ikTargetIndex = this.view.getInt32(this.offset, true);
+            this.offset += 4;
+            const ikIteration = this.view.getInt32(this.offset, true);
+            this.offset += 4;
+            const ikLimitAngle = this.view.getFloat32(this.offset, true);
+            this.offset += 4;
+            const ikLinkCount = this.view.getUint32(this.offset, true);
+            this.offset += 4;
+            const ikLinks = [];
+            for (let j = 0; j < ikLinkCount; j++) {
+                const boneIndex = this.view.getInt32(this.offset, true);
+                this.offset += 4;
+                const hasLimit = this.view.getUint8(this.offset) === 1;
+                this.offset += 1;
+                let minAngle = undefined;
+                let maxAngle = undefined;
+                if (hasLimit) {
+                    minAngle = new Vec3(this.view.getFloat32(this.offset, true), this.view.getFloat32(this.offset + 4, true), this.view.getFloat32(this.offset + 8, true));
+                    this.offset += 12;
+                    maxAngle = new Vec3(this.view.getFloat32(this.offset, true), this.view.getFloat32(this.offset + 4, true), this.view.getFloat32(this.offset + 8, true));
+                    this.offset += 12;
+                }
+                ikLinks.push({ boneIndex, hasLimit, minAngle, maxAngle });
+            }
+            const bone = {
+                name,
+                parentIndex: parentIndex >= 0 ? parentIndex : -1,
+                bindTranslation,
+                children: [], // Will be populated later
+                appendParentIndex: appendParentIndex >= 0 ? appendParentIndex : undefined,
+                appendRatio: appendRatio !== 0 ? appendRatio : undefined,
+                appendRotate: appendRotate || undefined,
+                appendMove: appendMove || undefined,
+                ikTargetIndex: ikTargetIndex >= 0 ? ikTargetIndex : undefined,
+                ikIteration: ikIteration > 0 ? ikIteration : undefined,
+                ikLimitAngle: ikLimitAngle > 0 ? ikLimitAngle : undefined,
+                ikLinks: ikLinks.length > 0 ? ikLinks : undefined,
+            };
+            bones.push(bone);
+        }
+        // Read inverse bind matrices
+        const invBindMatrices = new Float32Array(this.view.buffer.slice(this.offset, this.offset + boneCount * 16 * 4));
+        return { bones, inverseBindMatrices: invBindMatrices };
+    }
+    parseSkinning() {
+        const section = this.sections.get(SectionType.SKINNING);
+        if (!section)
+            throw new Error("Missing SKINNING section");
+        this.offset = section.offset;
+        const jointsLength = this.view.getUint32(this.offset, true);
+        this.offset += 4;
+        const joints = new Uint16Array(this.view.buffer, this.offset, jointsLength);
+        this.offset += jointsLength * 2;
+        const weightsLength = this.view.getUint32(this.offset, true);
+        this.offset += 4;
+        const weights = new Uint8Array(this.view.buffer, this.offset, weightsLength);
+        this.offset += weightsLength;
+        return { joints, weights };
+    }
+    parseMorphing() {
+        const section = this.sections.get(SectionType.MORPHING);
+        if (!section)
+            throw new Error("Missing MORPHING section");
+        this.offset = section.offset;
+        const morphCount = this.view.getUint32(this.offset, true);
+        this.offset += 4;
+        const morphs = [];
+        for (let i = 0; i < morphCount; i++) {
+            const nameLen = this.view.getUint32(this.offset, true);
+            this.offset += 4;
+            const nameBytes = new Uint8Array(this.view.buffer, this.offset, nameLen);
+            const name = new TextDecoder().decode(nameBytes);
+            this.offset += nameLen;
+            const type = this.view.getUint8(this.offset);
+            this.offset += 1;
+            const vertexOffsetCount = this.view.getUint32(this.offset, true);
+            this.offset += 4;
+            const vertexOffsets = [];
+            for (let j = 0; j < vertexOffsetCount; j++) {
+                const vertexIndex = this.view.getUint32(this.offset, true);
+                this.offset += 4;
+                const positionOffset = [
+                    this.view.getFloat32(this.offset, true),
+                    this.view.getFloat32(this.offset + 4, true),
+                    this.view.getFloat32(this.offset + 8, true),
+                ];
+                this.offset += 12;
+                vertexOffsets.push({ vertexIndex, positionOffset });
+            }
+            const groupRefCount = this.view.getUint32(this.offset, true);
+            this.offset += 4;
+            const groupReferences = [];
+            for (let j = 0; j < groupRefCount; j++) {
+                const morphIndex = this.view.getInt32(this.offset, true);
+                this.offset += 4;
+                const ratio = this.view.getFloat32(this.offset, true);
+                this.offset += 4;
+                groupReferences.push({ morphIndex, ratio });
+            }
+            morphs.push({
+                name,
+                type,
+                vertexOffsets,
+                groupReferences: groupReferences.length > 0 ? groupReferences : undefined,
+            });
+        }
+        // Read offsets buffer
+        const vertexCount = this.view.getUint32(this.sections.get(SectionType.GEOMETRY).offset, true);
+        const offsetsBufferSize = morphCount * vertexCount * 3;
+        const offsetsBuffer = new Float32Array(this.view.buffer, this.offset, offsetsBufferSize);
+        return { morphs, offsetsBuffer };
+    }
+    parseMaterials() {
+        const section = this.sections.get(SectionType.MATERIALS);
+        if (!section)
+            throw new Error("Missing MATERIALS section");
+        this.offset = section.offset;
+        const materialCount = this.view.getUint32(this.offset, true);
+        this.offset += 4;
+        const materials = [];
+        for (let i = 0; i < materialCount; i++) {
+            const nameLen = this.view.getUint32(this.offset, true);
+            this.offset += 4;
+            const nameBytes = new Uint8Array(this.view.buffer, this.offset, nameLen);
+            const name = new TextDecoder().decode(nameBytes);
+            this.offset += nameLen;
+            const diffuse = [
+                this.view.getFloat32(this.offset, true),
+                this.view.getFloat32(this.offset + 4, true),
+                this.view.getFloat32(this.offset + 8, true),
+                this.view.getFloat32(this.offset + 12, true),
+            ];
+            this.offset += 16;
+            const specular = [
+                this.view.getFloat32(this.offset, true),
+                this.view.getFloat32(this.offset + 4, true),
+                this.view.getFloat32(this.offset + 8, true),
+            ];
+            this.offset += 12;
+            const shininess = this.view.getFloat32(this.offset, true);
+            this.offset += 4;
+            const ambient = [
+                this.view.getFloat32(this.offset, true),
+                this.view.getFloat32(this.offset + 4, true),
+                this.view.getFloat32(this.offset + 8, true),
+            ];
+            this.offset += 12;
+            const diffuseTextureIndex = this.view.getInt32(this.offset, true);
+            this.offset += 4;
+            const normalTextureIndex = this.view.getInt32(this.offset, true);
+            this.offset += 4;
+            const sphereTextureIndex = this.view.getInt32(this.offset, true);
+            this.offset += 4;
+            const sphereMode = this.view.getUint8(this.offset);
+            this.offset += 1;
+            const toonTextureIndex = this.view.getInt32(this.offset, true);
+            this.offset += 4;
+            const edgeFlag = this.view.getUint8(this.offset);
+            this.offset += 1;
+            const edgeColor = [
+                this.view.getFloat32(this.offset, true),
+                this.view.getFloat32(this.offset + 4, true),
+                this.view.getFloat32(this.offset + 8, true),
+                this.view.getFloat32(this.offset + 12, true),
+            ];
+            this.offset += 16;
+            const edgeSize = this.view.getFloat32(this.offset, true);
+            this.offset += 4;
+            const vertexCount = this.view.getUint32(this.offset, true);
+            this.offset += 4;
+            const isEye = this.view.getUint8(this.offset) === 1;
+            this.offset += 1;
+            const isFace = this.view.getUint8(this.offset) === 1;
+            this.offset += 1;
+            const isHair = this.view.getUint8(this.offset) === 1;
+            this.offset += 1;
+            materials.push({
+                name,
+                diffuse,
+                specular,
+                ambient,
+                shininess,
+                diffuseTextureIndex,
+                normalTextureIndex,
+                sphereTextureIndex,
+                sphereMode,
+                toonTextureIndex,
+                edgeFlag,
+                edgeColor,
+                edgeSize,
+                vertexCount,
+                isEye,
+                isFace,
+                isHair,
+            });
+        }
+        return materials;
+    }
+    parseTextures() {
+        const section = this.sections.get(SectionType.TEXTURES);
+        if (!section)
+            throw new Error("Missing TEXTURES section");
+        this.offset = section.offset;
+        const textureCount = this.view.getUint32(this.offset, true);
+        this.offset += 4;
+        const textures = [];
+        for (let i = 0; i < textureCount; i++) {
+            const nameLen = this.view.getUint32(this.offset, true);
+            this.offset += 4;
+            const nameBytes = new Uint8Array(this.view.buffer, this.offset, nameLen);
+            const name = new TextDecoder().decode(nameBytes);
+            this.offset += nameLen;
+            const pathLen = this.view.getUint32(this.offset, true);
+            this.offset += 4;
+            const pathBytes = new Uint8Array(this.view.buffer, this.offset, pathLen);
+            const path = new TextDecoder().decode(pathBytes);
+            this.offset += pathLen;
+            // Read width, height, format, dataSize, and extract embedded data
+            const width = this.view.getUint32(this.offset, true);
+            this.offset += 4;
+            const height = this.view.getUint32(this.offset, true);
+            this.offset += 4;
+            const format = this.view.getUint8(this.offset);
+            this.offset += 1;
+            const dataSize = this.view.getUint32(this.offset, true);
+            this.offset += 4;
+            // Extract embedded texture data
+            let textureData = undefined;
+            if (dataSize > 0) {
+                textureData = this.view.buffer.slice(this.offset, this.offset + dataSize);
+            }
+            this.offset += dataSize;
+            textures.push({ name, path, data: textureData });
+        }
+        return textures;
+    }
+    parsePhysics() {
+        const section = this.sections.get(SectionType.PHYSICS);
+        if (!section) {
+            return { rigidbodies: [], joints: [] };
+        }
+        this.offset = section.offset;
+        const rigidbodyCount = this.view.getUint32(this.offset, true);
+        this.offset += 4;
+        const rigidbodies = [];
+        for (let i = 0; i < rigidbodyCount; i++) {
+            const nameLen = this.view.getUint32(this.offset, true);
+            this.offset += 4;
+            const nameBytes = new Uint8Array(this.view.buffer, this.offset, nameLen);
+            const name = new TextDecoder().decode(nameBytes);
+            this.offset += nameLen;
+            const englishNameLen = this.view.getUint32(this.offset, true);
+            this.offset += 4;
+            const englishNameBytes = new Uint8Array(this.view.buffer, this.offset, englishNameLen);
+            const englishName = new TextDecoder().decode(englishNameBytes);
+            this.offset += englishNameLen;
+            const boneIndex = this.view.getInt32(this.offset, true);
+            this.offset += 4;
+            const group = this.view.getUint8(this.offset);
+            this.offset += 1;
+            const collisionMask = this.view.getUint16(this.offset, true);
+            this.offset += 2;
+            const shape = this.view.getUint8(this.offset);
+            this.offset += 1;
+            const size = new Vec3(this.view.getFloat32(this.offset, true), this.view.getFloat32(this.offset + 4, true), this.view.getFloat32(this.offset + 8, true));
+            this.offset += 12;
+            const shapePosition = new Vec3(this.view.getFloat32(this.offset, true), this.view.getFloat32(this.offset + 4, true), this.view.getFloat32(this.offset + 8, true));
+            this.offset += 12;
+            const shapeRotation = new Vec3(this.view.getFloat32(this.offset, true), this.view.getFloat32(this.offset + 4, true), this.view.getFloat32(this.offset + 8, true));
+            this.offset += 12;
+            const mass = this.view.getFloat32(this.offset, true);
+            this.offset += 4;
+            const linearDamping = this.view.getFloat32(this.offset, true);
+            this.offset += 4;
+            const angularDamping = this.view.getFloat32(this.offset, true);
+            this.offset += 4;
+            const restitution = this.view.getFloat32(this.offset, true);
+            this.offset += 4;
+            const friction = this.view.getFloat32(this.offset, true);
+            this.offset += 4;
+            const type = this.view.getUint8(this.offset);
+            this.offset += 1;
+            rigidbodies.push({
+                name,
+                englishName,
+                boneIndex,
+                group,
+                collisionMask,
+                shape,
+                size,
+                shapePosition,
+                shapeRotation,
+                mass,
+                linearDamping,
+                angularDamping,
+                restitution,
+                friction,
+                type,
+                bodyOffsetMatrixInverse: Mat4.identity(),
+            });
+        }
+        const jointCount = this.view.getUint32(this.offset, true);
+        this.offset += 4;
+        const joints = [];
+        for (let i = 0; i < jointCount; i++) {
+            const nameLen = this.view.getUint32(this.offset, true);
+            this.offset += 4;
+            const nameBytes = new Uint8Array(this.view.buffer, this.offset, nameLen);
+            const name = new TextDecoder().decode(nameBytes);
+            this.offset += nameLen;
+            const englishNameLen = this.view.getUint32(this.offset, true);
+            this.offset += 4;
+            const englishNameBytes = new Uint8Array(this.view.buffer, this.offset, englishNameLen);
+            const englishName = new TextDecoder().decode(englishNameBytes);
+            this.offset += englishNameLen;
+            const type = this.view.getUint8(this.offset);
+            this.offset += 1;
+            const rigidbodyIndexA = this.view.getInt32(this.offset, true);
+            this.offset += 4;
+            const rigidbodyIndexB = this.view.getInt32(this.offset, true);
+            this.offset += 4;
+            const position = new Vec3(this.view.getFloat32(this.offset, true), this.view.getFloat32(this.offset + 4, true), this.view.getFloat32(this.offset + 8, true));
+            this.offset += 12;
+            const rotation = new Vec3(this.view.getFloat32(this.offset, true), this.view.getFloat32(this.offset + 4, true), this.view.getFloat32(this.offset + 8, true));
+            this.offset += 12;
+            const positionMin = new Vec3(this.view.getFloat32(this.offset, true), this.view.getFloat32(this.offset + 4, true), this.view.getFloat32(this.offset + 8, true));
+            this.offset += 12;
+            const positionMax = new Vec3(this.view.getFloat32(this.offset, true), this.view.getFloat32(this.offset + 4, true), this.view.getFloat32(this.offset + 8, true));
+            this.offset += 12;
+            const rotationMin = new Vec3(this.view.getFloat32(this.offset, true), this.view.getFloat32(this.offset + 4, true), this.view.getFloat32(this.offset + 8, true));
+            this.offset += 12;
+            const rotationMax = new Vec3(this.view.getFloat32(this.offset, true), this.view.getFloat32(this.offset + 4, true), this.view.getFloat32(this.offset + 8, true));
+            this.offset += 12;
+            const springPosition = new Vec3(this.view.getFloat32(this.offset, true), this.view.getFloat32(this.offset + 4, true), this.view.getFloat32(this.offset + 8, true));
+            this.offset += 12;
+            const springRotation = new Vec3(this.view.getFloat32(this.offset, true), this.view.getFloat32(this.offset + 4, true), this.view.getFloat32(this.offset + 8, true));
+            this.offset += 12;
+            joints.push({
+                name,
+                englishName,
+                type,
+                rigidbodyIndexA,
+                rigidbodyIndexB,
+                position,
+                rotation,
+                positionMin,
+                positionMax,
+                rotationMin,
+                rotationMax,
+                springPosition,
+                springRotation,
+            });
+        }
+        return { rigidbodies, joints };
+    }
+}
+RzmLoader.HEADER_SIZE = 36;
+RzmLoader.SECTION_TABLE_ENTRY_SIZE = 20;
+RzmLoader.MAGIC = "RZM\0";
+RzmLoader.VERSION = 1;

package/dist/rzm-writer.d.ts

@@ -0,0 +1,27 @@
+import { Model } from "./model";
+export declare class RzmWriter {
+    private sections;
+    private currentOffset;
+    private static readonly HEADER_SIZE;
+    private static readonly SECTION_TABLE_ENTRY_SIZE;
+    private static readonly MAGIC;
+    private static readonly VERSION;
+    /**
+     * Convert a Model to RZM binary format
+     * @param model The model to convert
+     * @param textureData Map of texture paths to their binary data (PNG/JPEG bytes)
+     * @returns RZM binary data as ArrayBuffer
+     */
+    static write(model: Model, textureData: Map<string, ArrayBuffer>): Promise<ArrayBuffer>;
+    private writeModel;
+    private writeGeometry;
+    private writeSkeleton;
+    private writeSkinning;
+    private writeMorphing;
+    private writeMaterials;
+    private writeTextures;
+    private writePhysics;
+    private addSection;
+    private finalize;
+}
+//# sourceMappingURL=rzm-writer.d.ts.map

package/dist/rzm-writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rzm-writer.d.ts","sourceRoot":"","sources":["../src/rzm-writer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAgE,MAAM,SAAS,CAAA;AA4C7F,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAgB;IAChC,OAAO,CAAC,aAAa,CAAI;IAGzB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAK;IACxC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,wBAAwB,CAAK;IACrD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAU;IACvC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAI;IAEnC;;;;;OAKG;WACU,KAAK,CAAC,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC;YAM/E,UAAU;IAiBxB,OAAO,CAAC,aAAa;IAwBrB,OAAO,CAAC,aAAa;IA2GrB,OAAO,CAAC,aAAa;IAyBrB,OAAO,CAAC,aAAa;IAqFrB,OAAO,CAAC,cAAc;YAgGR,aAAa;IAqH3B,OAAO,CAAC,YAAY;IA+NpB,OAAO,CAAC,UAAU;IAUlB,OAAO,CAAC,QAAQ;CA2CjB"}