123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296 |
- import { WebXRAbstractFeature } from "./WebXRAbstractFeature.js";
- import { Vector3, Quaternion } from "../../Maths/math.vector.js";
- import { PhysicsImpostor } from "../../Physics/v1/physicsImpostor.js";
- import { CreateSphere } from "../../Meshes/Builders/sphereBuilder.js";
- import { WebXRFeatureName, WebXRFeaturesManager } from "../webXRFeaturesManager.js";
- import { Logger } from "../../Misc/logger.js";
- /**
- * Options for the controller physics feature
- */
- export class IWebXRControllerPhysicsOptions {
- }
- /**
- * Add physics impostor to your webxr controllers,
- * including naive calculation of their linear and angular velocity
- */
- export class WebXRControllerPhysics extends WebXRAbstractFeature {
- _createPhysicsImpostor(xrController) {
- const impostorType = this._options.physicsProperties.impostorType || PhysicsImpostor.SphereImpostor;
- const impostorSize = this._options.physicsProperties.impostorSize || 0.1;
- const impostorMesh = CreateSphere("impostor-mesh-" + xrController.uniqueId, {
- diameterX: typeof impostorSize === "number" ? impostorSize : impostorSize.width,
- diameterY: typeof impostorSize === "number" ? impostorSize : impostorSize.height,
- diameterZ: typeof impostorSize === "number" ? impostorSize : impostorSize.depth,
- });
- impostorMesh.isVisible = this._debugMode;
- impostorMesh.isPickable = false;
- impostorMesh.rotationQuaternion = new Quaternion();
- const controllerMesh = xrController.grip || xrController.pointer;
- impostorMesh.position.copyFrom(controllerMesh.position);
- impostorMesh.rotationQuaternion.copyFrom(controllerMesh.rotationQuaternion);
- const impostor = new PhysicsImpostor(impostorMesh, impostorType, {
- mass: 0,
- ...this._options.physicsProperties,
- });
- this._controllers[xrController.uniqueId] = {
- xrController,
- impostor,
- impostorMesh,
- };
- }
- /**
- * Construct a new Controller Physics Feature
- * @param _xrSessionManager the corresponding xr session manager
- * @param _options options to create this feature with
- */
- constructor(_xrSessionManager, _options) {
- super(_xrSessionManager);
- this._options = _options;
- this._attachController = (xrController) => {
- if (this._controllers[xrController.uniqueId]) {
- // already attached
- return;
- }
- if (!this._xrSessionManager.scene.isPhysicsEnabled()) {
- Logger.Warn("physics engine not enabled, skipped. Please add this controller manually.");
- }
- // if no motion controller available, create impostors!
- if (this._options.physicsProperties.useControllerMesh && xrController.inputSource.gamepad) {
- xrController.onMotionControllerInitObservable.addOnce((motionController) => {
- if (!motionController._doNotLoadControllerMesh) {
- motionController.onModelLoadedObservable.addOnce(() => {
- const impostor = new PhysicsImpostor(motionController.rootMesh, PhysicsImpostor.MeshImpostor, {
- mass: 0,
- ...this._options.physicsProperties,
- });
- const controllerMesh = xrController.grip || xrController.pointer;
- this._controllers[xrController.uniqueId] = {
- xrController,
- impostor,
- oldPos: controllerMesh.position.clone(),
- oldRotation: controllerMesh.rotationQuaternion.clone(),
- };
- });
- }
- else {
- // This controller isn't using a model, create impostors instead
- this._createPhysicsImpostor(xrController);
- }
- });
- }
- else {
- this._createPhysicsImpostor(xrController);
- }
- };
- this._controllers = {};
- this._debugMode = false;
- this._delta = 0;
- this._lastTimestamp = 0;
- this._tmpQuaternion = new Quaternion();
- this._tmpVector = new Vector3();
- if (!this._options.physicsProperties) {
- this._options.physicsProperties = {};
- }
- }
- /**
- * @internal
- * enable debugging - will show console outputs and the impostor mesh
- */
- _enablePhysicsDebug() {
- this._debugMode = true;
- Object.keys(this._controllers).forEach((controllerId) => {
- const controllerData = this._controllers[controllerId];
- if (controllerData.impostorMesh) {
- controllerData.impostorMesh.isVisible = true;
- }
- });
- }
- /**
- * Manually add a controller (if no xrInput was provided or physics engine was not enabled)
- * @param xrController the controller to add
- */
- addController(xrController) {
- this._attachController(xrController);
- }
- /**
- * attach this feature
- * Will usually be called by the features manager
- *
- * @returns true if successful.
- */
- attach() {
- if (!super.attach()) {
- return false;
- }
- if (!this._options.xrInput) {
- return true;
- }
- this._options.xrInput.controllers.forEach(this._attachController);
- this._addNewAttachObserver(this._options.xrInput.onControllerAddedObservable, this._attachController);
- this._addNewAttachObserver(this._options.xrInput.onControllerRemovedObservable, (controller) => {
- // REMOVE the controller
- this._detachController(controller.uniqueId);
- });
- if (this._options.enableHeadsetImpostor) {
- const params = this._options.headsetImpostorParams || {
- impostorType: PhysicsImpostor.SphereImpostor,
- restitution: 0.8,
- impostorSize: 0.3,
- };
- const impostorSize = params.impostorSize || 0.3;
- this._headsetMesh = CreateSphere("headset-mesh", {
- diameterX: typeof impostorSize === "number" ? impostorSize : impostorSize.width,
- diameterY: typeof impostorSize === "number" ? impostorSize : impostorSize.height,
- diameterZ: typeof impostorSize === "number" ? impostorSize : impostorSize.depth,
- });
- this._headsetMesh.rotationQuaternion = new Quaternion();
- this._headsetMesh.isVisible = false;
- this._headsetImpostor = new PhysicsImpostor(this._headsetMesh, params.impostorType, { mass: 0, ...params });
- }
- return true;
- }
- /**
- * detach this feature.
- * Will usually be called by the features manager
- *
- * @returns true if successful.
- */
- detach() {
- if (!super.detach()) {
- return false;
- }
- Object.keys(this._controllers).forEach((controllerId) => {
- this._detachController(controllerId);
- });
- if (this._headsetMesh) {
- this._headsetMesh.dispose();
- }
- return true;
- }
- /**
- * Get the headset impostor, if enabled
- * @returns the impostor
- */
- getHeadsetImpostor() {
- return this._headsetImpostor;
- }
- /**
- * Get the physics impostor of a specific controller.
- * The impostor is not attached to a mesh because a mesh for each controller is not obligatory
- * @param controller the controller or the controller id of which to get the impostor
- * @returns the impostor or null
- */
- getImpostorForController(controller) {
- const id = typeof controller === "string" ? controller : controller.uniqueId;
- if (this._controllers[id]) {
- return this._controllers[id].impostor;
- }
- else {
- return null;
- }
- }
- /**
- * Update the physics properties provided in the constructor
- * @param newProperties the new properties object
- * @param newProperties.impostorType
- * @param newProperties.impostorSize
- * @param newProperties.friction
- * @param newProperties.restitution
- */
- setPhysicsProperties(newProperties) {
- this._options.physicsProperties = {
- ...this._options.physicsProperties,
- ...newProperties,
- };
- }
- _onXRFrame(_xrFrame) {
- this._delta = this._xrSessionManager.currentTimestamp - this._lastTimestamp;
- this._lastTimestamp = this._xrSessionManager.currentTimestamp;
- if (this._headsetMesh && this._headsetImpostor) {
- this._headsetMesh.position.copyFrom(this._options.xrInput.xrCamera.globalPosition);
- this._headsetMesh.rotationQuaternion.copyFrom(this._options.xrInput.xrCamera.absoluteRotation);
- if (this._options.xrInput.xrCamera._lastXRViewerPose?.linearVelocity) {
- const lv = this._options.xrInput.xrCamera._lastXRViewerPose.linearVelocity;
- this._tmpVector.set(lv.x, lv.y, lv.z);
- this._headsetImpostor.setLinearVelocity(this._tmpVector);
- }
- if (this._options.xrInput.xrCamera._lastXRViewerPose?.angularVelocity) {
- const av = this._options.xrInput.xrCamera._lastXRViewerPose.angularVelocity;
- this._tmpVector.set(av.x, av.y, av.z);
- this._headsetImpostor.setAngularVelocity(this._tmpVector);
- }
- }
- Object.keys(this._controllers).forEach((controllerId) => {
- const controllerData = this._controllers[controllerId];
- const controllerMesh = controllerData.xrController.grip || controllerData.xrController.pointer;
- const comparedPosition = controllerData.oldPos || controllerData.impostorMesh.position;
- if (controllerData.xrController._lastXRPose?.linearVelocity) {
- const lv = controllerData.xrController._lastXRPose.linearVelocity;
- this._tmpVector.set(lv.x, lv.y, lv.z);
- controllerData.impostor.setLinearVelocity(this._tmpVector);
- }
- else {
- controllerMesh.position.subtractToRef(comparedPosition, this._tmpVector);
- this._tmpVector.scaleInPlace(1000 / this._delta);
- controllerData.impostor.setLinearVelocity(this._tmpVector);
- }
- comparedPosition.copyFrom(controllerMesh.position);
- if (this._debugMode) {
- Logger.Log([this._tmpVector, "linear"]);
- }
- const comparedQuaternion = controllerData.oldRotation || controllerData.impostorMesh.rotationQuaternion;
- if (controllerData.xrController._lastXRPose?.angularVelocity) {
- const av = controllerData.xrController._lastXRPose.angularVelocity;
- this._tmpVector.set(av.x, av.y, av.z);
- controllerData.impostor.setAngularVelocity(this._tmpVector);
- }
- else {
- if (!comparedQuaternion.equalsWithEpsilon(controllerMesh.rotationQuaternion)) {
- // roughly based on this - https://www.gamedev.net/forums/topic/347752-quaternion-and-angular-velocity/
- comparedQuaternion.conjugateInPlace().multiplyToRef(controllerMesh.rotationQuaternion, this._tmpQuaternion);
- const len = Math.sqrt(this._tmpQuaternion.x * this._tmpQuaternion.x + this._tmpQuaternion.y * this._tmpQuaternion.y + this._tmpQuaternion.z * this._tmpQuaternion.z);
- this._tmpVector.set(this._tmpQuaternion.x, this._tmpQuaternion.y, this._tmpQuaternion.z);
- // define a better epsilon
- if (len < 0.001) {
- this._tmpVector.scaleInPlace(2);
- }
- else {
- const angle = 2 * Math.atan2(len, this._tmpQuaternion.w);
- this._tmpVector.scaleInPlace(angle / (len * (this._delta / 1000)));
- }
- controllerData.impostor.setAngularVelocity(this._tmpVector);
- }
- }
- comparedQuaternion.copyFrom(controllerMesh.rotationQuaternion);
- if (this._debugMode) {
- Logger.Log([this._tmpVector, this._tmpQuaternion, "angular"]);
- }
- });
- }
- _detachController(xrControllerUniqueId) {
- const controllerData = this._controllers[xrControllerUniqueId];
- if (!controllerData) {
- return;
- }
- if (controllerData.impostorMesh) {
- controllerData.impostorMesh.dispose();
- }
- // remove from the map
- delete this._controllers[xrControllerUniqueId];
- }
- }
- /**
- * The module's name
- */
- WebXRControllerPhysics.Name = WebXRFeatureName.PHYSICS_CONTROLLERS;
- /**
- * The (Babylon) version of this module.
- * This is an integer representing the implementation version.
- * This number does not correspond to the webxr specs version
- */
- WebXRControllerPhysics.Version = 1;
- //register the plugin
- WebXRFeaturesManager.AddWebXRFeature(WebXRControllerPhysics.Name, (xrSessionManager, options) => {
- return () => new WebXRControllerPhysics(xrSessionManager, options);
- }, WebXRControllerPhysics.Version, true);
- //# sourceMappingURL=WebXRControllerPhysics.js.map
|