More API doc +

dist/preview release/typedocValidationBaseline.json

@@ -17196,613 +17196,6 @@
         }
       }
     },
-    "Quaternion": {
-      "Class": {
-        "Comments": {
-          "MissingText": true
-        }
-      },
-      "Property": {
-        "w": {
-          "Comments": {
-            "MissingText": true
-          }
-        },
-        "x": {
-          "Comments": {
-            "MissingText": true
-          }
-        },
-        "y": {
-          "Comments": {
-            "MissingText": true
-          }
-        },
-        "z": {
-          "Comments": {
-            "MissingText": true
-          }
-        }
-      },
-      "Method": {
-        "add": {
-          "Comments": {
-            "MissingReturn": true
-          },
-          "Parameter": {
-            "other": {
-              "Comments": {
-                "MissingText": true
-              }
-            }
-          }
-        },
-        "asArray": {
-          "Comments": {
-            "MissingReturn": true
-          }
-        },
-        "clone": {
-          "Comments": {
-            "MissingReturn": true
-          }
-        },
-        "conjugate": {
-          "Comments": {
-            "MissingReturn": true
-          }
-        },
-        "conjugateInPlace": {
-          "Comments": {
-            "MissingReturn": true
-          }
-        },
-        "conjugateToRef": {
-          "Comments": {
-            "MissingReturn": true
-          },
-          "Parameter": {
-            "ref": {
-              "Comments": {
-                "MissingText": true
-              }
-            }
-          }
-        },
-        "copyFrom": {
-          "Comments": {
-            "MissingReturn": true
-          },
-          "Parameter": {
-            "other": {
-              "Comments": {
-                "MissingText": true
-              }
-            }
-          }
-        },
-        "copyFromFloats": {
-          "Comments": {
-            "MissingReturn": true
-          },
-          "Parameter": {
-            "x": {
-              "Comments": {
-                "MissingText": true
-              }
-            },
-            "y": {
-              "Comments": {
-                "MissingText": true
-              }
-            },
-            "z": {
-              "Comments": {
-                "MissingText": true
-              }
-            },
-            "w": {
-              "Comments": {
-                "MissingText": true
-              }
-            }
-          }
-        },
-        "equals": {
-          "Comments": {
-            "MissingReturn": true
-          },
-          "Parameter": {
-            "otherQuaternion": {
-              "Comments": {
-                "MissingText": true
-              }
-            }
-          }
-        },
-        "fromRotationMatrix": {
-          "Comments": {
-            "MissingReturn": true
-          },
-          "Parameter": {
-            "matrix": {
-              "Comments": {
-                "MissingText": true
-              }
-            }
-          }
-        },
-        "getClassName": {
-          "Comments": {
-            "MissingReturn": true
-          }
-        },
-        "getHashCode": {
-          "Comments": {
-            "MissingReturn": true
-          }
-        },
-        "length": {
-          "Comments": {
-            "MissingReturn": true
-          }
-        },
-        "multiply": {
-          "Comments": {
-            "MissingReturn": true
-          },
-          "Parameter": {
-            "q1": {
-              "Comments": {
-                "MissingText": true
-              }
-            }
-          }
-        },
-        "multiplyInPlace": {
-          "Comments": {
-            "MissingReturn": true
-          },
-          "Parameter": {
-            "q1": {
-              "Comments": {
-                "MissingText": true
-              }
-            }
-          }
-        },
-        "multiplyToRef": {
-          "Comments": {
-            "MissingReturn": true
-          },
-          "Parameter": {
-            "q1": {
-              "Comments": {
-                "MissingText": true
-              }
-            },
-            "result": {
-              "Comments": {
-                "MissingText": true
-              }
-            }
-          }
-        },
-        "normalize": {
-          "Comments": {
-            "MissingReturn": true
-          }
-        },
-        "scale": {
-          "Comments": {
-            "MissingReturn": true
-          },
-          "Parameter": {
-            "value": {
-              "Comments": {
-                "MissingText": true
-              }
-            }
-          }
-        },
-        "set": {
-          "Comments": {
-            "MissingReturn": true
-          },
-          "Parameter": {
-            "x": {
-              "Comments": {
-                "MissingText": true
-              }
-            },
-            "y": {
-              "Comments": {
-                "MissingText": true
-              }
-            },
-            "z": {
-              "Comments": {
-                "MissingText": true
-              }
-            },
-            "w": {
-              "Comments": {
-                "MissingText": true
-              }
-            }
-          }
-        },
-        "subtract": {
-          "Comments": {
-            "MissingReturn": true
-          },
-          "Parameter": {
-            "other": {
-              "Comments": {
-                "MissingText": true
-              }
-            }
-          }
-        },
-        "toRotationMatrix": {
-          "Comments": {
-            "MissingReturn": true
-          },
-          "Parameter": {
-            "result": {
-              "Comments": {
-                "MissingText": true
-              }
-            }
-          }
-        },
-        "ToString": {
-          "Comments": {
-            "MissingReturn": true
-          }
-        },
-        "FromArray": {
-          "Comments": {
-            "MissingReturn": true
-          },
-          "Parameter": {
-            "array": {
-              "Comments": {
-                "MissingText": true
-              }
-            },
-            "offset": {
-              "Comments": {
-                "MissingText": true
-              }
-            }
-          }
-        },
-        "FromRotationMatrix": {
-          "Comments": {
-            "MissingReturn": true
-          },
-          "Parameter": {
-            "matrix": {
-              "Comments": {
-                "MissingText": true
-              }
-            }
-          }
-        },
-        "FromRotationMatrixToRef": {
-          "Parameter": {
-            "matrix": {
-              "Comments": {
-                "MissingText": true
-              }
-            },
-            "result": {
-              "Comments": {
-                "MissingText": true
-              }
-            }
-          }
-        },
-        "Hermite": {
-          "Comments": {
-            "MissingReturn": true
-          },
-          "Parameter": {
-            "value1": {
-              "Comments": {
-                "MissingText": true
-              }
-            },
-            "tangent1": {
-              "Comments": {
-                "MissingText": true
-              }
-            },
-            "value2": {
-              "Comments": {
-                "MissingText": true
-              }
-            },
-            "tangent2": {
-              "Comments": {
-                "MissingText": true
-              }
-            },
-            "amount": {
-              "Comments": {
-                "MissingText": true
-              }
-            }
-          }
-        },
-        "Identity": {
-          "Comments": {
-            "MissingReturn": true
-          }
-        },
-        "Inverse": {
-          "Comments": {
-            "MissingReturn": true
-          },
-          "Parameter": {
-            "q": {
-              "Comments": {
-                "MissingText": true
-              }
-            }
-          }
-        },
-        "IsIdentity": {
-          "Comments": {
-            "MissingText": true
-          },
-          "Parameter": {
-            "quaternion": {
-              "Comments": {
-                "MissingText": true
-              }
-            }
-          }
-        },
-        "RotationAlphaBetaGamma": {
-          "Comments": {
-            "MissingReturn": true
-          },
-          "Parameter": {
-            "alpha": {
-              "Comments": {
-                "MissingText": true
-              }
-            },
-            "beta": {
-              "Comments": {
-                "MissingText": true
-              }
-            },
-            "gamma": {
-              "Comments": {
-                "MissingText": true
-              }
-            }
-          }
-        },
-        "RotationAlphaBetaGammaToRef": {
-          "Parameter": {
-            "alpha": {
-              "Comments": {
-                "MissingText": true
-              }
-            },
-            "beta": {
-              "Comments": {
-                "MissingText": true
-              }
-            },
-            "gamma": {
-              "Comments": {
-                "MissingText": true
-              }
-            },
-            "result": {
-              "Comments": {
-                "MissingText": true
-              }
-            }
-          }
-        },
-        "RotationAxis": {
-          "Comments": {
-            "MissingReturn": true
-          },
-          "Parameter": {
-            "axis": {
-              "Comments": {
-                "MissingText": true
-              }
-            },
-            "angle": {
-              "Comments": {
-                "MissingText": true
-              }
-            }
-          }
-        },
-        "RotationAxisToRef": {
-          "Comments": {
-            "MissingReturn": true
-          },
-          "Parameter": {
-            "axis": {
-              "Comments": {
-                "MissingText": true
-              }
-            },
-            "angle": {
-              "Comments": {
-                "MissingText": true
-              }
-            },
-            "result": {
-              "Comments": {
-                "MissingText": true
-              }
-            }
-          }
-        },
-        "RotationQuaternionFromAxis": {
-          "Comments": {
-            "MissingReturn": true
-          },
-          "Parameter": {
-            "axis1": {
-              "Comments": {
-                "MissingText": true
-              }
-            },
-            "axis2": {
-              "Comments": {
-                "MissingText": true
-              }
-            },
-            "axis3": {
-              "Comments": {
-                "MissingText": true
-              }
-            },
-            "ref": {
-              "Comments": {
-                "MissingText": true
-              }
-            }
-          }
-        },
-        "RotationQuaternionFromAxisToRef": {
-          "Parameter": {
-            "axis1": {
-              "Comments": {
-                "MissingText": true
-              }
-            },
-            "axis2": {
-              "Comments": {
-                "MissingText": true
-              }
-            },
-            "axis3": {
-              "Comments": {
-                "MissingText": true
-              }
-            },
-            "ref": {
-              "Comments": {
-                "MissingText": true
-              }
-            }
-          }
-        },
-        "RotationYawPitchRoll": {
-          "Comments": {
-            "MissingReturn": true
-          },
-          "Parameter": {
-            "yaw": {
-              "Comments": {
-                "MissingText": true
-              }
-            },
-            "pitch": {
-              "Comments": {
-                "MissingText": true
-              }
-            },
-            "roll": {
-              "Comments": {
-                "MissingText": true
-              }
-            }
-          }
-        },
-        "RotationYawPitchRollToRef": {
-          "Parameter": {
-            "yaw": {
-              "Comments": {
-                "MissingText": true
-              }
-            },
-            "pitch": {
-              "Comments": {
-                "MissingText": true
-              }
-            },
-            "roll": {
-              "Comments": {
-                "MissingText": true
-              }
-            },
-            "result": {
-              "Comments": {
-                "MissingText": true
-              }
-            }
-          }
-        },
-        "Slerp": {
-          "Comments": {
-            "MissingText": true
-          },
-          "Parameter": {
-            "left": {
-              "Comments": {
-                "MissingText": true
-              }
-            },
-            "right": {
-              "Comments": {
-                "MissingText": true
-              }
-            },
-            "amount": {
-              "Comments": {
-                "MissingText": true
-              }
-            }
-          }
-        },
-        "SlerpToRef": {
-          "Comments": {
-            "MissingText": true
-          },
-          "Parameter": {
-            "left": {
-              "Comments": {
-                "MissingText": true
-              }
-            },
-            "right": {
-              "Comments": {
-                "MissingText": true
-              }
-            },
-            "amount": {
-              "Comments": {
-                "MissingText": true
-              }
-            },
-            "result": {
-              "Comments": {
-                "MissingText": true
-              }
-            }
-          }
-        },
-        "Zero": {
-          "Comments": {
-            "MissingReturn": true
-          }
-        }
-      }
-    },
     "QuinticEase": {
       "Class": {
         "Comments": {

src/Animations/babylon.animation.ts

@@ -96,9 +96,20 @@
         STEP = 1
     }
 
+    /**
+     * Class used to store any kind of animation
+     */
     export class Animation {
+        /**
+         * Gets or sets a general value used to allow matrices interpolation (off by default as it could be expensive)
+         */
         public static AllowMatricesInterpolation = false;
 
+        /**
+         * Gets or sets a boolean indicating if Matrix.DecomposeLerp should be used instead of Matrix.Lerp for matrix interpolation
+         */
+        public static AllowMatrixDecomposeForInterpolation = true;
+
         private _keys: Array<IAnimationKey>;
         private _easingFunction: IEasingFunction;
 
@@ -449,6 +460,10 @@
         }
 
         public matrixInterpolateFunction(startValue: Matrix, endValue: Matrix, gradient: number): Matrix {
+            if (Animation.AllowMatrixDecomposeForInterpolation) {
+                return Matrix.DecomposeLerp(startValue, endValue, gradient);
+            }
+
             return Matrix.Lerp(startValue, endValue, gradient);
         }