Source: extern/math.js

  1. import register from "../util/register.js";
  3. import * as m_vec3 from "../libs/gl_matrix/vec3.js";
  4. import * as m_util from "../intern/util.js";
  5. import * as m_math from "../intern/math.js";
  7. /**
  8.  * Auxiliary math methods. For math methods operating on vectors, matrices or quaternions see the
  9.  * corresponding modules.
  10.  * @module math
  11.  * @local Plane
  12.  */
  13. function Math(ns, exports) {
  15. var _vec3_tmp = new Float32Array(3);
  17. /**
  18.  * Plane represented as vec3 normal and distance to the origin.
  19.  * @typedef {Float32Array(4)} Plane
  20.  */
  22. /**
  23.  * Get the parametric line.
  24.  * @method module:math.create_pline_from_points
  25.  * @param {Vec3} point1 First point.
  26.  * @param {Vec3} point2 Second point.
  27.  * @returns {ParametricLine} Parametric line.
  28.  */
  29. exports.create_pline_from_points = function(point1, point2) {
  30.     var dest = new Float32Array(6);
  31.     m_math.set_pline_initial_point(dest, point1);
  33.     m_vec3.subtract(point2, point1, _vec3_tmp);
  35.     m_math.set_pline_directional_vec(dest, _vec3_tmp);
  37.     return dest;
  38. }
  40. /**
  41.  * Get the parametric line.
  42.  * @method module:math.create_pline_from_point_vec
  43.  * @param {Vec3} point First point.
  44.  * @param {Vec3} vec Directional vector.
  45.  * @returns {ParametricLine} Parametric line.
  46.  */
  47. exports.create_pline_from_point_vec = function(point, vec) {
  48.     var dest = new Float32Array(6);
  49.     m_math.set_pline_initial_point(dest, point);
  50.     m_math.set_pline_directional_vec(dest, vec);
  52.     return dest;
  53. }
  55. /**
  56.  * Init the parametric line.
  57.  * @method module:math.create_pline
  58.  * @returns {ParametricLine} pline Parametric line.
  59.  */
  60. exports.create_pline = function() {
  61.     return new Float32Array(6);
  62. }
  63. /**
  64.  * Get the parametric line directional vector.
  65.  * @method module:math.get_pline_directional_vec
  66.  * @param {ParametricLine} pline Parametric line.
  67.  * @param {?Vec3} [dest=new Float32Array(3);] Destination vector.
  68.  * @returns {?Vec3} Destination vector.
  69.  */
  70. exports.get_pline_directional_vec = m_math.get_pline_directional_vec;
  71. /**
  72.  * Get the parametric line initial point.
  73.  * @method module:math.get_pline_initial_point
  74.  * @param {ParametricLine} pline Parametric line.
  75.  * @param {?Vec3} [dest=new Float32Array(3);] Destination point.
  76.  * @returns {?Vec3} Destination point.
  77.  */
  78. exports.get_pline_initial_point = m_math.get_pline_initial_point;
  79. /**
  80.  * Set the parametric line initial point.
  81.  * @method module:math.set_pline_initial_point
  82.  * @param {ParametricLine} pline Parametric line.
  83.  * @param {Vec3} vec3 Point.
  84.  */
  85. exports.set_pline_initial_point = m_math.set_pline_initial_point;
  86. /**
  87.  * Set the parametric line directional vector.
  88.  * @method module:math.set_pline_directional_vec
  89.  * @param {ParametricLine} pline Parametric line.
  90.  * @param {Vec3} vec3 Vector.
  91.  */
  92. exports.set_pline_directional_vec = m_math.set_pline_directional_vec;
  93. /**
  94.  * Calculate intersection point of a line and a plane.
  95.  * @method module:math.line_plane_intersect
  96.  * @see Lengyel E. - Mathematics for 3D Game Programming and Computer Graphics,
  97.  * Third Edition. Chapter 5.2.1 Intersection of a Line and a Plane
  98.  * @param {Vec3} pn Plane normal.
  99.  * @param {number} p_dist Plane signed distance from the origin.
  100.  * @param {ParametricLine} pline Parametric line.
  101.  * @param {Vec3} dest Destination vector.
  102.  * @returns {?Vec3} Intersection point or null if the line is parallel to the plane.
  103.  */
  104. exports.line_plane_intersect = m_util.line_plane_intersect
  105. /**
  106.  * Get the coordinates of a certain point on the given parametric line.
  107.  * @method module:math.calc_pline_point
  108.  * @param {ParametricLine} pline Parametric line.
  109.  * @param {number} t Parameter - distance from the line initial point to a certain point.
  110.  * @param {?Vec3} [dest=new Float32Array(3);] Destination point.
  111.  * @returns {?Vec3} Destination point.
  112.  */
  113. exports.calc_pline_point = m_math.calc_pline_point;
  114. /**
  115.  * Calculate distance from point to plane.
  116.  * @method module:math.point_plane_dist
  117.  * @param {Vec3} point Point.
  118.  * @param {Plane} plane Plane.
  119.  * @returns {number} Distance.
  120.  */
  121. exports.point_plane_dist = m_math.point_plane_dist;
  122. /**
  123.  * Interpolate value with no easing, no acceleration.
  124.  * @method module:math.linear_tween
  125.  * @param {number} t Current time.
  126.  * @param {number} b Start value.
  127.  * @param {number} c Change in value.
  128.  * @param {number} d Duration.
  129.  * @returns {number} Interpolated value.
  130.  */
  131. exports.linear_tween = m_math.linear_tween;
  132. /**
  133.  * Interpolate value with accelerating from zero velocity.
  134.  * @method module:math.ease_in_quad
  135.  * @param {number} t Current time.
  136.  * @param {number} b Start value.
  137.  * @param {number} c Change in value.
  138.  * @param {number} d Duration.
  139.  * @returns {number} Interpolated value.
  140.  */
  141. exports.ease_in_quad = m_math.ease_in_quad;
  142. /**
  143.  * Interpolate value with decelerating to zero velocity.
  144.  * @method module:math.ease_out_quad
  145.  * @param {number} t Current time.
  146.  * @param {number} b Start value.
  147.  * @param {number} c Change in value.
  148.  * @param {number} d Duration.
  149.  * @returns {number} Interpolated value.
  150.  */
  151. exports.ease_out_quad = m_math.ease_out_quad;
  152. /**
  153.  * Interpolate value with acceleration until halfway, then deceleration.
  154.  * @method module:math.ease_in_out_quad
  155.  * @param {number} t Current time.
  156.  * @param {number} b Start value.
  157.  * @param {number} c Change in value.
  158.  * @param {number} d Duration.
  159.  * @returns {number} Interpolated value.
  160.  */
  161. exports.ease_in_out_quad = m_math.ease_in_out_quad;
  162. /**
  163.  * Interpolate value with accelerating from zero velocity.
  164.  * @method module:math.ease_in_cubic
  165.  * @param {number} t Current time.
  166.  * @param {number} b Start value.
  167.  * @param {number} c Change in value.
  168.  * @param {number} d Duration.
  169.  * @returns {number} Interpolated value.
  170.  */
  171. exports.ease_in_cubic = m_math.ease_in_cubic;
  172. /**
  173.  * Interpolate value with decelerating to zero velocity.
  174.  * @method module:math.ease_out_cubic
  175.  * @param {number} t Current time.
  176.  * @param {number} b Start value.
  177.  * @param {number} c Change in value.
  178.  * @param {number} d Duration.
  179.  * @returns {number} Interpolated value.
  180.  */
  181. exports.ease_out_cubic = m_math.ease_out_cubic;
  182. /**
  183.  * Interpolate value with acceleration until halfway, then deceleration.
  184.  * @method module:math.ease_in_out_cubic
  185.  * @param {number} t Current time.
  186.  * @param {number} b Start value.
  187.  * @param {number} c Change in value.
  188.  * @param {number} d Duration.
  189.  * @returns {number} Interpolated value.
  190.  */
  191. exports.ease_in_out_cubic = m_math.ease_in_out_cubic;
  192. /**
  193.  * Interpolate value with accelerating from zero velocity.
  194.  * @method module:math.ease_in_quart
  195.  * @param {number} t Current time.
  196.  * @param {number} b Start value.
  197.  * @param {number} c Change in value.
  198.  * @param {number} d Duration.
  199.  * @returns {number} Interpolated value.
  200.  */
  201. exports.ease_in_quart = m_math.ease_in_quart;
  202. /**
  203.  * Interpolate value with decelerating to zero velocity.
  204.  * @method module:math.ease_out_quart
  205.  * @param {number} t Current time.
  206.  * @param {number} b Start value.
  207.  * @param {number} c Change in value.
  208.  * @param {number} d Duration.
  209.  * @returns {number} Interpolated value.
  210.  */
  211. exports.ease_out_quart = m_math.ease_out_quart;
  212. /**
  213.  * Interpolate value with acceleration until halfway, then deceleration.
  214.  * @method module:math.ease_in_out_quart
  215.  * @param {number} t Current time.
  216.  * @param {number} b Start value.
  217.  * @param {number} c Change in value.
  218.  * @param {number} d Duration.
  219.  * @returns {number} Interpolated value.
  220.  */
  221. exports.ease_in_out_quart = m_math.ease_in_out_quart;
  222. /**
  223.  * Interpolate value with decelerating from zero velocity.
  224.  * @method module:math.ease_in_quint
  225.  * @param {number} t Current time.
  226.  * @param {number} b Start value.
  227.  * @param {number} c Change in value.
  228.  * @param {number} d Duration.
  229.  * @returns {number} Interpolated value.
  230.  */
  231. exports.ease_in_quint = m_math.ease_in_quint;
  232. /**
  233.  * Interpolate value with decelerating to zero velocity.
  234.  * @method module:math.ease_out_quint
  235.  * @param {number} t Current time.
  236.  * @param {number} b Start value.
  237.  * @param {number} c Change in value.
  238.  * @param {number} d Duration.
  239.  * @returns {number} Interpolated value.
  240.  */
  241. exports.ease_out_quint = m_math.ease_out_quint;
  242. /**
  243.  * Interpolate value with acceleration until halfway, then deceleration.
  244.  * @method module:math.ease_in_out_quint
  245.  * @param {number} t Current time.
  246.  * @param {number} b Start value.
  247.  * @param {number} c Change in value.
  248.  * @param {number} d Duration.
  249.  * @returns {number} Interpolated value.
  250.  */
  251. exports.ease_in_out_quint = m_math.ease_in_out_quint;
  252. /**
  253.  * Interpolate value with decelerating from zero velocity.
  254.  * @method module:math.ease_in_sine
  255.  * @param {number} t Current time.
  256.  * @param {number} b Start value.
  257.  * @param {number} c Change in value.
  258.  * @param {number} d Duration.
  259.  * @returns {number} Interpolated value.
  260.  */
  261. exports.ease_in_sine = m_math.ease_in_sine;
  262. /**
  263.  * Interpolate value with decelerating to zero velocity.
  264.  * @method module:math.ease_out_sine
  265.  * @param {number} t Current time.
  266.  * @param {number} b Start value.
  267.  * @param {number} c Change in value.
  268.  * @param {number} d Duration.
  269.  * @returns {number} Interpolated value.
  270.  */
  271. exports.ease_out_sine = m_math.ease_out_sine;
  272. /**
  273.  * Interpolate value with acceleration until halfway, then decelerating.
  274.  * @method module:math.ease_in_out_sine
  275.  * @param {number} t Current time.
  276.  * @param {number} b Start value.
  277.  * @param {number} c Change in value.
  278.  * @param {number} d Duration.
  279.  * @returns {number} Interpolated value.
  280.  */
  281. exports.ease_in_out_sine = m_math.ease_in_out_sine;
  282. /**
  283.  * Interpolate value with decelerating from zero velocity.
  284.  * @method module:math.ease_in_expo
  285.  * @param {number} t Current time.
  286.  * @param {number} b Start value.
  287.  * @param {number} c Change in value.
  288.  * @param {number} d Duration.
  289.  * @returns {number} Interpolated value.
  290.  */
  291. exports.ease_in_expo = m_math.ease_in_expo;
  292. /**
  293.  * Interpolate value with decelerating to zero velocity.
  294.  * @method module:math.ease_out_expo
  295.  * @param {number} t Current time.
  296.  * @param {number} b Start value.
  297.  * @param {number} c Change in value.
  298.  * @param {number} d Duration.
  299.  * @returns {number} Interpolated value.
  300.  */
  301. exports.ease_out_expo = m_math.ease_out_expo;
  302. /**
  303.  * Interpolate value with acceleration until halfway, then decelerating.
  304.  * @method module:math.ease_in_out_expo
  305.  * @param {number} t Current time.
  306.  * @param {number} b Start value.
  307.  * @param {number} c Change in value.
  308.  * @param {number} d Duration.
  309.  * @returns {number} Interpolated value.
  310.  */
  311. exports.ease_in_out_expo = m_math.ease_in_out_expo;
  312. /**
  313.  * Interpolate value with decelerating from zero velocity.
  314.  * @method module:math.ease_in_circ
  315.  * @param {number} t Current time.
  316.  * @param {number} b Start value.
  317.  * @param {number} c Change in value.
  318.  * @param {number} d Duration.
  319.  * @returns {number} Interpolated value.
  320.  */
  321. exports.ease_in_circ = m_math.ease_in_circ;
  322. /**
  323.  * Interpolate value with decelerating to zero velocity.
  324.  * @method module:math.ease_out_circ
  325.  * @param {number} t Current time.
  326.  * @param {number} b Start value.
  327.  * @param {number} c Change in value.
  328.  * @param {number} d Duration.
  329.  * @returns {number} Interpolated value.
  330.  */
  331. exports.ease_out_circ = m_math.ease_out_circ;
  332. /**
  333.  * Interpolate value with acceleration until halfway, then deceleration.
  334.  * @method module:math.ease_in_out_circ
  335.  * @param {number} t Current time.
  336.  * @param {number} b Start value.
  337.  * @param {number} c Change in value.
  338.  * @param {number} d Duration.
  339.  * @returns {number} Interpolated value.
  340.  */
  341. exports.ease_in_out_circ = m_math.ease_in_out_circ;
  342. /**
  343.  * Interpolate value with decelerating from zero velocity.
  344.  * @method module:math.ease_in_elastic
  345.  * @param {number} t Current time.
  346.  * @param {number} b Start value.
  347.  * @param {number} c Change in value.
  348.  * @param {number} d Duration.
  349.  * @returns {number} Interpolated value.
  350.  */
  351. exports.ease_in_elastic = m_math.ease_in_elastic;
  352. /**
  353.  * Interpolate value with decelerating to zero velocity.
  354.  * @method module:math.ease_out_elastic
  355.  * @param {number} t Current time.
  356.  * @param {number} b Start value.
  357.  * @param {number} c Change in value.
  358.  * @param {number} d Duration.
  359.  * @returns {number} Interpolated value.
  360.  */
  361. exports.ease_out_elastic = m_math.ease_out_elastic;
  362. /**
  363.  * Interpolate value with acceleration until halfway, then deceleration.
  364.  * @method module:math.ease_in_out_elastic
  365.  * @param {number} t Current time.
  366.  * @param {number} b Start value.
  367.  * @param {number} c Change in value.
  368.  * @param {number} d Duration.
  369.  * @returns {number} Interpolated value.
  370.  */
  371. exports.ease_in_out_elastic = m_math.ease_in_out_elastic;
  372. /**
  373.  * Interpolate value with decelerating from zero velocity.
  374.  * @method module:math.ease_in_back
  375.  * @param {number} t Current time.
  376.  * @param {number} b Start value.
  377.  * @param {number} c Change in value.
  378.  * @param {number} d Duration.
  379.  * @returns {number} Interpolated value.
  380.  */
  381. exports.ease_in_back = m_math.ease_in_back;
  382. /**
  383.  * Interpolate value with decelerating to zero velocity.
  384.  * @method module:math.ease_out_back
  385.  * @param {number} t Current time.
  386.  * @param {number} b Start value.
  387.  * @param {number} c Change in value.
  388.  * @param {number} d Duration.
  389.  * @returns {number} Interpolated value.
  390.  */
  391. exports.ease_out_back = m_math.ease_out_back;
  392. /**
  393.  * Interpolate value with acceleration until halfway, then deceleration.
  394.  * @method module:math.ease_in_out_back
  395.  * @param {number} t Current time.
  396.  * @param {number} b Start value.
  397.  * @param {number} c Change in value.
  398.  * @param {number} d Duration.
  399.  * @returns {number} Interpolated value.
  400.  */
  401. exports.ease_in_out_back = m_math.ease_in_out_back;
  402. /**
  403.  * Interpolate value with decelerating from zero velocity.
  404.  * @method module:math.ease_in_bounce
  405.  * @param {number} t Current time.
  406.  * @param {number} b Start value.
  407.  * @param {number} c Change in value.
  408.  * @param {number} d Duration.
  409.  * @returns {number} Interpolated value.
  410.  */
  411. exports.ease_in_bounce = m_math.ease_in_bounce;
  412. /**
  413.  * Interpolate value with decelerating to zero velocity.
  414.  * @method module:math.ease_out_bounce
  415.  * @param {number} t Current time.
  416.  * @param {number} b Start value.
  417.  * @param {number} c Change in value.
  418.  * @param {number} d Duration.
  419.  * @returns {number} Interpolated value.
  420.  */
  421. exports.ease_out_bounce = m_math.ease_out_bounce;
  422. /**
  423.  * Interpolate value with acceleration until halfway, then deceleration.
  424.  * @method module:math.ease_in_out_bounce
  425.  * @param {number} t Current time.
  426.  * @param {number} b Start value.
  427.  * @param {number} c Change in value.
  428.  * @param {number} d Duration.
  429.  * @returns {number} Interpolated value.
  430.  */
  431. exports.ease_in_out_bounce = m_math.ease_in_out_bounce;
  433. }
  435. var math_factory = register("math", Math);
  437. export default math_factory;