roavatar-renderer 1.0.1 → 1.0.3

package/README.md

@@ -8,6 +8,10 @@ Also available on npm: https://www.npmjs.com/package/roavatar-renderer
 IMPORTANT: Assets are NOT included in the npm module or this repository, you have to get them from the main RoAvatar repository
 
 Basic (not really) example on how to load an avatar, that is also untested:
+```html
+<!--I know this is kind of terrible but... it has to be included-->
+<script src="/draco_decoder.js"></script>
+```
 ```ts
 //setup instance wrappers and renderer
 RegisterWrappers()

package/dist/index.d.ts

@@ -57,6 +57,8 @@ export declare const AccessoryType: {
 
 export declare const ActualBundleTypes: string[];
 
+export declare function add(v0: Vec3, v1: Vec3): Vec3;
+
 export declare const AllAccessorySorts: ItemSort[];
 
 export declare const AllAnimations: AnimationProp[];
@@ -429,6 +431,8 @@ export declare const AvatarType: {
     [K in AvatarType]: AvatarType;
 };
 
+export declare function barycentric(p: Vec3, triangle: Triangle): Vec3;
+
 export declare function base64ToArrayBuffer(base64: string): ArrayBuffer;
 
 declare class BaseKeyframe {
@@ -583,6 +587,8 @@ export declare interface BundleDetails_Result {
 
 export declare const BundleTypes: string[];
 
+export declare function calculateMagnitude3D(x: number, y: number, z: number): number;
+
 export declare function calculateMotor6Doffset(motor: Instance, includeTransform?: boolean): CFrame;
 
 export declare const CatalogBundleTypes: string[];
@@ -609,10 +615,14 @@ export declare class CFrame {
     isSame(other: CFrame): boolean;
 }
 
+export declare function clamp(v0: Vec3, lower: Vec3, higher: Vec3): Vec3;
+
 export declare function clonePrimitiveArray<T>(arr: T[]): T[];
 
 export declare function cloneSearch_Payload(data: Search_Payload): Search_Payload;
 
+export declare function closestPointTriangle(p: Vec3, triangle: Triangle): Vec3;
+
 declare type ClothingDiffType = "Shirt" | "Pants" | "GraphicTShirt";
 
 export declare class Color3 {
@@ -680,6 +690,18 @@ declare class COREMESH {
     getTouchingVerts(index: number): number[];
 }
 
+export declare function createMeshChunks(mesh: FileMesh, widthSplit: number, heightSplit: number, depthSplit: number): MeshChunk[];
+
+/**THIS FUNCTION IS SO EXPENSIVE IT NEEDS TO BE ASYNC SO JS DOESNT CRASH, USE CHUNKED VERSION INSTEAD
+ */
+export declare function createWeightsForMesh(mesh: FileMesh, ref_mesh: FileMesh): Promise<number[][]>;
+
+export declare function createWeightsForMeshChunked(mesh: FileMesh, ref_mesh: FileMesh): WeightChunk[];
+
+export declare function createWeightsForMeshChunkedOLD(mesh: FileMesh, ref_mesh: FileMesh): WeightChunk[];
+
+export declare function cross(a: Vec3, b: Vec3): Vec3;
+
 export declare const DataType: {
     String: number;
     Bool: number;
@@ -736,6 +758,8 @@ export declare const defaultShirtAssetIds: number[];
 
 export declare const defaultShirtTemplateAssetIds: number[];
 
+export declare function deformReferenceToBaseBodyParts(reference: FileMesh, targetCages: FileMesh[], targetSizes: Vector3[], targetCFrames: CFrame[]): number[];
+
 export declare function deg(radians: number): number;
 
 declare class DisposableDesc {
@@ -745,6 +769,12 @@ declare class DisposableDesc {
     dispose(_renderer: THREE.WebGLRenderer, _scene: THREE.Scene): void;
 }
 
+export declare function distance(v0: Vec3, v1: Vec3): number;
+
+export declare function divide(v0: Vec3, v1: Vec3): Vec3;
+
+export declare function dot(v0: Vec3, v1: Vec3): number;
+
 export declare function download(filename: string, text: string): void;
 
 export declare const EmitterGroupDescClassTypes: string[];
@@ -794,7 +824,7 @@ declare class FACS {
     clone(): FACS;
 }
 
-declare class FileMesh {
+export declare class FileMesh {
     version: string;
     facsDataFormat: number;
     sizeOfFacsData: number;
@@ -848,13 +878,13 @@ declare class FileMeshFace {
     clone(): FileMeshFace;
 }
 
-declare class FileMeshSkinning {
+export declare class FileMeshSkinning {
     subsetIndices: Vec4;
     boneWeights: Vec4;
     clone(): FileMeshSkinning;
 }
 
-declare class FileMeshSubset {
+export declare class FileMeshSubset {
     facesBegin: number;
     facesLength: number;
     vertsBegin: number;
@@ -864,7 +894,7 @@ declare class FileMeshSubset {
     clone(): FileMeshSubset;
 }
 
-declare class FileMeshVertex {
+export declare class FileMeshVertex {
     position: Vec3;
     normal: Vec3;
     uv: Vec2;
@@ -916,12 +946,22 @@ declare class FloatCurveKey {
     rightTangent?: number;
 }
 
+export declare function floor(v0: Vec3): Vec3;
+
 export declare const FullBodyColors: string[];
 
+export declare function gaussian_rbf(v0: Vec3, v1: Vec3, sigma?: number): number;
+
 export declare function generateUUIDv4(): string;
 
 export declare function GetAttachedPart(accessory: Instance, rig: Instance): Instance | undefined;
 
+export declare function getDistVertArray(ref: FileMesh, dist: FileMesh): (FileMeshVertex | undefined)[];
+
+export declare function getOffsetArray(inner: FileMesh, outer: FileMesh): ([Vec3, THREE.Quaternion, number] | undefined)[];
+
+export declare function getOffsetMap(inner: FileMesh, outer: FileMesh): Map<number, Vec3>;
+
 export declare function getOriginalSize(part: Instance): Vector3;
 
 export declare function getRandomBetweenInclusive(min: number, max: number): number;
@@ -955,6 +995,12 @@ export declare interface GetTopics_Result {
     }[];
 }
 
+export declare function getUVtoVertMap(mesh: FileMesh): Map<number, FileMeshVertex[]>;
+
+export declare function hashVec2(x: number, y: number): number;
+
+export declare function hashVec3(x: number, y: number, z: number, distance: number): number;
+
 export declare function hasSameVal(instance0: Instance, instance1: Instance, propertyName: string): boolean;
 
 export declare function hasSameValFloat(instance0: Instance, instance1: Instance, propertyName: string): boolean;
@@ -1042,6 +1088,10 @@ export declare const HumanoidRigType: {
 
 export declare function imageUrlToDataUrl(imageUrl: string): Promise<string>;
 
+export declare function inheritSkeleton(to: FileMesh, from: FileMesh): void;
+
+export declare function inheritUV(to: FileMesh, from: FileMesh): void;
+
 declare class INST {
     classID: number;
     className: string;
@@ -1188,6 +1238,23 @@ export declare class ItemSort {
 
 declare type ItemType = "Asset" | "Bundle" | "Outfit" | "Look" | "None";
 
+declare class KDNode {
+    point: Vec3;
+    index: number;
+    axis: number;
+    left: KDNode | null;
+    right: KDNode | null;
+    constructor(point: Vec3, index: number, axis: number);
+}
+
+export declare function layerClothing(mesh: FileMesh, ref_mesh: FileMesh, dist_mesh: FileMesh): Promise<void>;
+
+export declare function layerClothingChunked(mesh: FileMesh, ref_mesh: FileMesh, dist_mesh: FileMesh, cacheId?: string): void;
+
+export declare function layerClothingChunkedNormals(mesh: FileMesh, ref_mesh: FileMesh, dist_mesh: FileMesh, cacheId?: string): void;
+
+export declare function layerClothingChunkedNormals2(mesh: FileMesh, ref_mesh: FileMesh, dist_mesh: FileMesh, cacheId?: string): void;
+
 export declare const LayeredAssetTypes: string[];
 
 export declare const LayeredClothingAssetOrder: {
@@ -1321,6 +1388,8 @@ export declare interface Look_Result {
 
 export declare const magic = "<roblox!";
 
+export declare function magnitude(v: Vec3): number;
+
 export declare const MainToSubNames: {
     [K in string]: string[];
 };
@@ -1367,9 +1436,9 @@ export declare interface MarketplaceWidgets_Result {
     configuration: unknown;
 }
 
-declare type Mat3x3 = [number, number, number, number, number, number, number, number, number];
+export declare type Mat3x3 = [number, number, number, number, number, number, number, number, number];
 
-declare type Mat4x4 = [number, number, number, number, number, number, number, number, number, number, number, number, number, number, number, number];
+export declare type Mat4x4 = [number, number, number, number, number, number, number, number, number, number, number, number, number, number, number, number];
 
 export declare function mathRandom(min: number, max: number): number;
 
@@ -1382,6 +1451,13 @@ export declare const MaxPerAsset: {
     [K in string]: number;
 };
 
+export declare function mergeTargetWithReference(reference: FileMesh, target: FileMesh, targetSize: Vector3, targetCFrame: CFrame): number[];
+
+export declare type MeshChunk = {
+    pos: Vec3;
+    indices: number[];
+};
+
 export declare const MeshType: {
     Brick: number;
     Cylinder: number;
@@ -1394,6 +1470,8 @@ export declare const MeshType: {
 
 export declare const minimumDeltaEBodyColorDifference = 11.4;
 
+export declare function minus(v0: Vec3, v1: Vec3): Vec3;
+
 export declare class ModelWrapper extends InstanceWrapper {
     static className: string;
     static requiredProperties: string[];
@@ -1404,6 +1482,8 @@ export declare class ModelWrapper extends InstanceWrapper {
 
 export declare function mount(container: HTMLDivElement): void;
 
+export declare function multiply(v0: Vec3, v1: Vec3): Vec3;
+
 export declare interface NavigationMenuItems {
     categories: {
         category: string;
@@ -1489,6 +1569,8 @@ export declare const NormalId: {
     Front: number;
 };
 
+export declare function normalize(v: Vec3): Vec3;
+
 export declare class NumberRange {
     Min: number;
     Max: number;
@@ -1516,6 +1598,12 @@ export declare class NumberSequenceKeypoint {
 
 export declare const ObjectDescClassTypes: string[];
 
+export declare function offsetMesh(mesh: FileMesh, cframe: CFrame): void;
+
+export declare function offsetMeshWithRotation(mesh: FileMesh, cframe: CFrame): void;
+
+export declare function offsetRefMeshLikeInnerAndOuter(ref_mesh: FileMesh, inner: FileMesh, outer: FileMesh): void;
+
 export declare class Outfit {
     scale: Scale;
     bodyColors: BodyColors | BodyColor3s;
@@ -1627,6 +1715,12 @@ declare class PartKeyframeGroup extends BaseKeyframeGroup {
     getLowerKeyframe(time: number): PartKeyframe | null;
 }
 
+declare type Patch = {
+    center: Vec3;
+    neighborIndices: number[];
+    weights?: Float32Array;
+};
+
 declare class PRNT {
     instanceCount: number;
     childReferents: number[];
@@ -1698,6 +1792,44 @@ export declare class Ray {
     clone(): Ray;
 }
 
+export declare function ray_intersects_triangle(ray_origin: Vec3, ray_vector: Vec3, triangle: Triangle): Vec3 | null;
+
+/**
+ * This is a naive (think thats what its called) implementation of the RBF deformer, it is extremely slow
+ * Use RBFDeformerPatch instead
+ */
+export declare class RBFDeformer {
+    refVerts: FileMeshVertex[];
+    distVerts: FileMeshVertex[];
+    weights: Vec3[] | undefined;
+    constructor(refMesh: FileMesh, distMesh: FileMesh);
+    solve(): void;
+    deform(vec: Vec3): Vec3;
+    deformMesh(mesh: FileMesh): void;
+}
+
+export declare class RBFDeformerPatch {
+    mesh: FileMesh;
+    refVerts: FileMeshVertex[];
+    distVerts: FileMeshVertex[];
+    importantIndices: number[];
+    controlKD: KDNode | null;
+    patchKD: KDNode | null;
+    patches: Patch[];
+    patchCenters: Vec3[];
+    patchCenterIndices: number[];
+    nearestPatch: Uint16Array;
+    K: number;
+    patchCount: number;
+    epsilon: number;
+    affectBones: boolean;
+    id: number;
+    constructor(refMesh: FileMesh, distMesh: FileMesh, mesh: FileMesh, ignoredIndices?: number[], patchCount?: number, detailsCount?: 48, importantsCount?: 32);
+    solveAsync(): Promise<void>;
+    deform(i: number): Vec3;
+    deformMesh(): void;
+}
+
 export declare class RBX {
     classCount: number;
     instanceCount: number;
@@ -1926,6 +2058,8 @@ declare type ScaleJson = {
     bodyType?: number;
 };
 
+export declare function scaleMesh(mesh: FileMesh, scale: Vector3): void;
+
 export declare type ScaleName = "height" | "width" | "head" | "depth" | "proportion" | "bodyType";
 
 export declare class ScriptWrapper extends InstanceWrapper {
@@ -2096,11 +2230,15 @@ export declare const ToRemoveBeforeBundleType: {
     Character: string[];
 };
 
+export declare function transferSkeleton(to: FileMesh, from: FileMesh): void;
+
 export declare function traverseRigCFrame(instance: Instance): CFrame;
 
 export declare function traverseRigInstance(instance: Instance): Instance[];
 
-declare type Triangle = [Vec3, Vec3, Vec3];
+export declare type Triangle = [Vec3, Vec3, Vec3];
+
+export declare function triangleNormal(triangle: Triangle): Vec3;
 
 declare type TwoPoseCorrective = Vec2;
 
@@ -2156,11 +2294,11 @@ declare type ValidationIssue = {
 
 declare type ValidationIssueType = "AccessoryLimit" | "LayeredLimit" | "OneOfTypeLimit" | "DuplicateId" | "NotWearable" | "MissingLayeredMeta" | "InvalidAsset";
 
-declare type Vec2 = [number, number];
+export declare type Vec2 = [number, number];
 
-declare type Vec3 = [number, number, number];
+export declare type Vec3 = [number, number, number];
 
-declare type Vec4 = [number, number, number, number];
+export declare type Vec4 = [number, number, number, number];
 
 export declare class Vector2 {
     X: number;
@@ -2202,10 +2340,21 @@ declare type Vecxyz = {
 
 export declare function versionToNumber(version: string): number;
 
+export declare function vertPosToChunkPos(pos: Vec3, meshSize: Vec3, widthSplit: number, heightSplit: number, depthSplit: number): Vec3;
+
 export declare function Wait(time: number): Promise<unknown>;
 
 export declare const WearableAssetTypes: string[];
 
+export declare type WeightChunk = {
+    meshChunk: MeshChunk;
+    weights: number[];
+};
+
+export declare type WeightChunk3 = WeightChunk & {
+    weights: Vec3[];
+};
+
 export declare const WrapLayerAutoSkin: {
     Disabled: number;
     EnabledPreserve: number;