MotrixSimWeb/src/types.ts
2026-06-25 04:46:31 +08:00

255 lines
5.9 KiB
TypeScript

export type AxisUp = "Y" | "Z";
export type Handedness = "right" | "left";
export interface CoordinateSystem {
up: AxisUp;
handedness?: Handedness;
}
export type Vec3 = [number, number, number];
export type Quat = [number, number, number, number];
export interface Pose {
position?: Vec3;
quaternion?: Quat;
euler?: Vec3;
scale?: Vec3;
}
export interface PreviewMaterial {
id: string;
color?: string;
opacity?: number;
roughness?: number;
metalness?: number;
wireframe?: boolean;
textureUrl?: string;
textureKind?: "checker";
textureColors?: [string, string];
textureRepeat?: [number, number];
}
export type PrimitiveKind = "box" | "sphere" | "capsule" | "cylinder" | "plane" | "axes";
export type MeshFormat = "gltf" | "glb" | "obj" | "stl";
export interface PrimitiveGeometry {
kind: "primitive";
primitive: PrimitiveKind;
size?: Vec3;
radius?: number;
length?: number;
segments?: number;
}
export interface MeshGeometry {
kind: "mesh";
url: string;
format?: MeshFormat;
materialOverride?: string;
}
export interface ConvexMeshGeometry {
kind: "convexMesh";
vertices: number[];
faces?: number[];
}
export type PreviewGeometry = PrimitiveGeometry | MeshGeometry | ConvexMeshGeometry;
export interface PreviewObject {
id: string;
name?: string;
body?: string;
physics?: "dynamic" | "fixed" | "stateOnly" | "visualOnly";
parent?: string;
editableGroup?: string;
editableGroupRole?: "anchor" | "member";
geometry: PreviewGeometry;
pose?: Pose;
material?: string;
visible?: boolean;
castShadow?: boolean;
receiveShadow?: boolean;
}
export interface PreviewLight {
type: "ambient" | "directional" | "hemisphere";
color?: string;
intensity?: number;
position?: Vec3;
}
export interface PreviewCamera {
position?: Vec3;
target?: Vec3;
fov?: number;
near?: number;
far?: number;
}
export interface PreviewStateSource {
mode: "replay" | "poll" | "websocket" | "none";
url?: string;
controlUrl?: string;
fps?: number;
loop?: boolean;
pollIntervalMs?: number;
activeBodiesAfterInitial?: boolean;
}
export interface JointControlSpec {
name: string;
index?: number;
range?: [number, number];
value?: number;
}
export interface ActuatorControlSpec {
name: string;
index?: number;
range?: [number, number];
targetName?: string;
value?: number;
}
export interface KeyboardControlSpec {
source?: string;
command?: {
forward?: string[];
backward?: string[];
strafeLeft?: string[];
strafeRight?: string[];
yawLeft?: string[];
yawRight?: string[];
};
camera?: {
rotate?: string;
pan?: string;
zoom?: string;
focusMarker?: boolean;
};
}
export interface PreviewControls {
joints?: JointControlSpec[];
actuators?: ActuatorControlSpec[];
keyboard?: KeyboardControlSpec;
}
export interface SceneCompositeInfo {
type?: string;
sources?: string[];
storeObjects?: number;
visualObjects?: number;
note?: string;
}
export interface SceneManifest {
version: string;
name: string;
description?: string;
units?: "m" | "cm" | "mm";
coordinateSystem?: CoordinateSystem;
materials?: PreviewMaterial[];
objects: PreviewObject[];
lights?: PreviewLight[];
camera?: PreviewCamera;
state?: PreviewStateSource;
controls?: PreviewControls;
composite?: SceneCompositeInfo;
}
export interface BodyState {
pos?: Vec3;
quat?: Quat;
qpos?: number[];
joints?: Record<string, number>;
}
export interface PreviewFrame {
step?: number;
time?: number;
server_time?: number;
paused?: boolean;
running?: boolean;
bodyPayload?: {
mode?: "full" | "active";
count?: number;
total?: number;
filtered?: number;
};
link_names?: string[];
joint_names?: string[];
joints?: Record<string, { pos: number; vel?: number; range?: [number, number]; index?: number }>;
actuators?: Record<string, { ctrl: number; range?: [number, number]; index?: number; targetName?: string }>;
command?: [number, number, number];
bodies?: Record<string, BodyState>;
}
export interface ReplayStateFile {
frames: PreviewFrame[];
}
export interface RendererStats {
manifestName: string;
objectCount: number;
bodyBoundObjectCount: number;
largeSceneMode: boolean;
targetRenderFps: number;
actualRenderFps: number;
renderPixelRatio: number;
preserveDrawingBufferEnabled: boolean;
shadowsEnabled: boolean;
renderSkipCount: number;
lastRenderDurationMs: number;
readbackRenderCount: number;
hoverPickIntervalMs: number;
frozenStaticObjectCount: number;
preFrozenMeshCloneCount: number;
spinningScanSkippedCount: number;
instancedMeshObjectCount: number;
instancedMeshBatchCount: number;
instancedMeshDrawCount: number;
instancedMeshMatrixUpdateCount: number;
manualMatrixRootCount: number;
manualMatrixUpdateCount: number;
primitiveGeometryCount: number;
pickProxyCount: number;
appliedBodyStateCount: number;
skippedBodyStateCount: number;
unchangedFrameCount: number;
releasedGeometryCount: number;
releasedMaterialCount: number;
releasedTextureCount: number;
loadedMeshCount: number;
fallbackCount: number;
meshCacheSourceCount: number;
meshCacheHitCount: number;
meshCacheMissCount: number;
retainedMeshGeometryCount: number;
retainedMeshMaterialCount: number;
sceneObjectBoundsCount: number;
fastPickProxyBoundsCount: number;
meshSourceBoundsCount: number;
hoverProxyBoundsHitCount: number;
hoverCachedBoundsHitCount: number;
hoverRootBoundsFallbackCount: number;
cameraFitTraversalCount: number;
sceneLoadSuppressedRenderCount: number;
sceneBuildYieldCount: number;
statePayloadBodyCount: number;
mergedBodyStateCount: number;
reducedStateFrameCount: number;
incrementalBodyMergeCount: number;
batchedSceneRootCount: number;
sceneRootBatchCount: number;
editableGroupCount: number;
groupedObjectCount: number;
frameCount: number;
lastStep?: number;
lastBodyCount: number;
paused?: boolean;
running?: boolean;
nonBackgroundPixelSamples?: number;
}