Source: extern/transform.js

  1. import register from "../util/register.js";
  3. import * as m_bounds from "../intern/boundings.js";
  4. import m_obj_util_fact from "../intern/obj_util.js";
  5. import m_phy_fact from "../intern/physics.js";
  6. import m_print_fact from "../intern/print.js";
  7. import * as m_quat from "../libs/gl_matrix/quat.js";
  8. import m_trans_fact from "../intern/transform.js";
  9. import * as m_tsr from "../intern/tsr.js";
  10. import * as m_util from "../intern/util.js";
  12. /**
  13.  * Object transformations API.
  14.  * With some exceptions specified below, make sure that the objects are dynamic.
  15.  * @module transform
  16.  */
  17. function Transform(ns, exports) {
  19. var m_obj_util = m_obj_util_fact(ns);
  20. var m_phy      = m_phy_fact(ns);
  21. var m_print    = m_print_fact(ns);
  22. var m_trans    = m_trans_fact(ns);
  24. var _tsr_tmp = m_tsr.create();
  25. var _vec3_tmp = new Float32Array(3);
  26. var _quat4_tmp = new Float32Array(4);
  28. /**
  29.  * Set the object translation.
  30.  * @method module:transform.set_translation
  31.  * @param {Object3D} obj Object 3D
  32.  * @param {number} x X coord
  33.  * @param {number} y Y coord
  34.  * @param {number} z Z coord
  35.  */
  36. exports.set_translation = function(obj, x, y, z) {
  37.     if (m_obj_util.is_dynamic(obj)) {
  38.         _vec3_tmp[0] = x;
  39.         _vec3_tmp[1] = y;
  40.         _vec3_tmp[2] = z;
  42.         m_trans.set_translation(obj, _vec3_tmp);
  43.         m_trans.update_transform(obj);
  44.         m_phy.sync_transform(obj);
  45.     } else
  46.         m_print.error("Wrong object: \"" + obj.name + "\" is not dynamic.");
  47. }
  48. /**
  49.  * Set the object translation (in the coordinate space of its parent).
  50.  * @method module:transform.set_translation_rel
  51.  * @param {Object3D} obj Object 3D
  52.  * @param {number} x X coord
  53.  * @param {number} y Y coord
  54.  * @param {number} z Z coord
  55.  */
  56. exports.set_translation_rel = function(obj, x, y, z) {
  57.     if (m_obj_util.is_dynamic(obj)) {
  58.         _vec3_tmp[0] = x;
  59.         _vec3_tmp[1] = y;
  60.         _vec3_tmp[2] = z;
  62.         m_trans.set_translation_rel(obj, _vec3_tmp);
  63.         m_trans.update_transform(obj);
  64.         m_phy.sync_transform(obj);
  65.     } else
  66.         m_print.error("Wrong object: \"" + obj.name + "\" is not dynamic.");
  67. }
  69. /**
  70.  * Set the object translation (vector form).
  71.  * @method module:transform.set_translation_v
  72.  * @param {Object3D} obj Object 3D
  73.  * @param {Vec3} trans Translation vector
  74.  */
  75. exports.set_translation_v = function(obj, trans) {
  76.     if (m_obj_util.is_dynamic(obj)) {
  77.         m_trans.set_translation(obj, trans);
  78.         m_trans.update_transform(obj);
  79.         m_phy.sync_transform(obj);
  80.     } else
  81.         m_print.error("Wrong object: \"" + obj.name + "\" is not dynamic.");
  82. }
  84. /**
  85.  * Set the object translation in vector form
  86.  * (in the coordinate space of its parent).
  87.  * @method module:transform.set_translation_rel_v
  88.  * @param {Object3D} obj Object 3D
  89.  * @param {Vec3} trans Translation vector
  90.  */
  91. exports.set_translation_rel_v = function(obj, trans) {
  92.     if (m_obj_util.is_dynamic(obj)) {
  93.         m_trans.set_translation_rel(obj, trans);
  94.         m_trans.update_transform(obj);
  95.         m_phy.sync_transform(obj);
  96.     } else
  97.         m_print.error("Wrong object: \"" + obj.name + "\" is not dynamic.");
  98. }
  100. /**
  101.  * Set the object translation relatively to another object.
  102.  * @method module:transform.set_translation_obj_rel
  103.  * @param {Object3D} obj Transformed object
  104.  * @param {number} x X coord
  105.  * @param {number} y Y coord
  106.  * @param {number} z Z coord
  107.  * @param {Object3D} obj_ref Reference object
  108.  */
  109. exports.set_translation_obj_rel = function(obj, x, y, z, obj_ref) {
  110.     if (m_obj_util.is_dynamic(obj)) {
  111.         _vec3_tmp[0] = x;
  112.         _vec3_tmp[1] = y;
  113.         _vec3_tmp[2] = z;
  115.         var trans = m_tsr.get_trans_view(obj_ref.render.world_tsr);
  116.         var quat = m_tsr.get_quat_view(obj_ref.render.world_tsr);
  118.         m_util.transform_vec3(_vec3_tmp, 1, quat, trans, _vec3_tmp);
  120.         m_trans.set_translation(obj, _vec3_tmp);
  121.         m_trans.update_transform(obj);
  122.         m_phy.sync_transform(obj);
  123.     } else
  124.         m_print.error("Wrong object: \"" + obj.name + "\" is not dynamic.");
  125. }
  127. /**
  128.  * Get the object's translation vector.
  129.  * @method module:transform.get_translation
  130.  * @param {Object3D} obj Object 3D
  131.  * @param {Vec3} [dest] Destination vector
  132.  * @returns {Vec3} Destination vector
  133.  * @example 
  134.  * var m_scenes = require("scenes");
  135.  * var m_trans = require("transform");
  136.  * var m_vec3 = require("vec3");
  137.  * // precache 3D vector
  138.  * var _vec3_tmp = m_vec3.create();
  139.  * // ...
  140.  * var cube = m_scenes.get_object_by_name("Cube");
  141.  * var translation = m_trans.get_translation(cube, _vec3_tmp);
  142.  */
  143. exports.get_translation = function(obj, dest) {
  144.     if (!dest)
  145.         dest = new Float32Array(3);
  147.     m_trans.get_translation(obj, dest);
  148.     return dest;
  149. }
  151. /**
  152.  * Get the object's translation vector (in the coordinate space of its parent).
  153.  * @method module:transform.get_translation_rel
  154.  * @param {Object3D} obj Object 3D
  155.  * @param {Vec3} [dest] Destination vector
  156.  * @returns {Vec3} Destination vector
  157.  */
  158. exports.get_translation_rel = function(obj, dest) {
  159.     if (!dest)
  160.         dest = new Float32Array(3);
  162.     m_trans.get_translation_rel(obj, dest);
  163.     return dest;
  164. }
  166. /**
  167.  * Set the object's rotation quaternion.
  168.  * @method module:transform.set_rotation
  169.  * @param {Object3D} obj Object 3D
  170.  * @param {number} x X part of quaternion
  171.  * @param {number} y Y part of quaternion
  172.  * @param {number} z Z part of quaternion
  173.  * @param {number} w W part of quaternion
  174.  */
  175. exports.set_rotation = function(obj, x, y, z, w) {
  176.     if (m_obj_util.is_dynamic(obj)) {
  177.         _quat4_tmp[0] = x;
  178.         _quat4_tmp[1] = y;
  179.         _quat4_tmp[2] = z;
  180.         _quat4_tmp[3] = w;
  182.         m_trans.set_rotation(obj, _quat4_tmp);
  183.         m_trans.update_transform(obj);
  184.         m_phy.sync_transform(obj);
  185.     } else
  186.         m_print.error("Wrong object: \"" + obj.name + "\" is not dynamic.");
  187. }
  189. /**
  190.  * Set the object's rotation quaternion (in the coordinate space of its parent).
  191.  * @method module:transform.set_rotation_rel
  192.  * @param {Object3D} obj Object 3D
  193.  * @param {number} x X part of quaternion
  194.  * @param {number} y Y part of quaternion
  195.  * @param {number} z Z part of quaternion
  196.  * @param {number} w W part of quaternion
  197.  */
  198. exports.set_rotation_rel = function(obj, x, y, z, w) {
  199.     if (m_obj_util.is_dynamic(obj)) {
  200.         _quat4_tmp[0] = x;
  201.         _quat4_tmp[1] = y;
  202.         _quat4_tmp[2] = z;
  203.         _quat4_tmp[3] = w;
  205.         m_trans.set_rotation_rel(obj, _quat4_tmp);
  206.         m_trans.update_transform(obj);
  207.         m_phy.sync_transform(obj);
  208.     } else
  209.         m_print.error("Wrong object: \"" + obj.name + "\" is not dynamic.");
  210. }
  212. /**
  213.  * Set the object's rotation in vector form.
  214.  * @method module:transform.set_rotation_v
  215.  * @param {Object3D} obj Object 3D
  216.  * @param {Quat} quat Quaternion vector
  217.  */
  218. exports.set_rotation_v = function(obj, quat) {
  219.     if (m_obj_util.is_dynamic(obj)) {
  220.         m_trans.set_rotation(obj, quat);
  221.         m_trans.update_transform(obj);
  222.         m_phy.sync_transform(obj);
  223.     } else
  224.         m_print.error("Wrong object: \"" + obj.name + "\" is not dynamic.");
  225. }
  226. /**
  227.  * Set the object's rotation in vector form
  228.  * (in the coordinate space of its parent).
  229.  * @method module:transform.set_rotation_rel_v
  230.  * @param {Object3D} obj Object 3D
  231.  * @param {Quat} quat Quaternion vector
  232.  */
  233. exports.set_rotation_rel_v = function(obj, quat) {
  234.     if (m_obj_util.is_dynamic(obj)) {
  235.         m_trans.set_rotation_rel(obj, quat);
  236.         m_trans.update_transform(obj);
  237.         m_phy.sync_transform(obj);
  238.     } else
  239.         m_print.error("Wrong object: \"" + obj.name + "\" is not dynamic.");
  240. }
  241. /**
  242.  * Get the object's rotation in vector form
  243.  * (in the coordinate space of its parent).
  244.  * @method module:transform.set_rotation_rel_v
  245.  * @param {Object3D} obj Object 3D
  246.  * @param {Quat} quat Quaternion vector
  247.  * @returns {Quat} Destination vector
  248.  * @example 
  249.  * var m_scenes = require("scenes");
  250.  * var m_trans = require("transform");
  251.  * var m_quat  = require("quat");
  252.  * // precache quaternion
  253.  * var _quat_tmp = m_quat.create();
  254.  * // ...
  255.  * var cube = m_scenes.get_object_by_name("Cube");
  256.  * var rot_quat = m_trans.get_rotation_rel_v(cube, _quat_tmp);
  257.  */
  258. exports.get_rotation_rel_v = function(obj, quat) {
  259.     if (m_obj_util.is_dynamic(obj)) {
  260.         m_trans.get_rotation_rel(obj, quat);
  261.         return quat;
  262.     } else
  263.         m_print.error("Wrong object: \"" + obj.name + "\" is not dynamic.");
  264. }
  266. /**
  267.  * Get the object's rotation quaternion.
  268.  * @method module:transform.get_rotation
  269.  * @param {Object3D} obj Object 3D
  270.  * @param {Quat} [opt_dest] Destination vector
  271.  * @returns {Quat} Destination vector
  272.  * @example 
  273.  * var m_scenes = require("scenes");
  274.  * var m_trans = require("transform");
  275.  * var m_quat  = require("quat");
  276.  * // precache quaternion
  277.  * var _quat_tmp = m_quat.create();
  278.  * // ...
  279.  * var cube = m_scenes.get_object_by_name("Cube");
  280.  * var rot_quat = m_trans.get_rotation(cube, _quat_tmp);
  281.  */
  282. exports.get_rotation = function(obj, opt_dest) {
  283.     if (!opt_dest)
  284.         opt_dest = new Float32Array(4);
  286.     m_trans.get_rotation(obj, opt_dest);
  287.     return opt_dest;
  288. }
  290. /**
  291.  * Get the object's rotation quaternion
  292.  * (in the coordinate space of its parent).
  293.  * @method module:transform.get_rotation_rel
  294.  * @param {Object3D} obj Object 3D
  295.  * @param {Quat} [opt_dest] Destination vector
  296.  * @returns {Quat} Destination vector
  297.  */
  298. exports.get_rotation_rel = function(obj, opt_dest) {
  299.     if (!opt_dest)
  300.         opt_dest = new Float32Array(4);
  302.     m_trans.get_rotation_rel(obj, opt_dest);
  303.     return opt_dest;
  304. }
  306. /**
  307.  * Set euler rotation in the ZYX intrinsic system.
  308.  * Using euler angles is discouraged, use quaternion instead.
  309.  * @method module:transform.set_rotation_euler
  310.  * @param {Object3D} obj Object 3D
  311.  * @param {number} x Angle X in radians
  312.  * @param {number} y Angle Y in radians
  313.  * @param {number} z Angle Z in radians
  314.  */
  315. exports.set_rotation_euler = function(obj, x, y, z) {
  316.     if (m_obj_util.is_dynamic(obj)) {
  317.         _vec3_tmp[0] = x;
  318.         _vec3_tmp[1] = y;
  319.         _vec3_tmp[2] = z;
  321.         m_trans.set_rotation_euler(obj, _vec3_tmp);
  322.         m_trans.update_transform(obj);
  323.         m_phy.sync_transform(obj);
  324.     } else
  325.         m_print.error("Wrong object: \"" + obj.name + "\" is not dynamic.");
  326. }
  328. /**
  329.  * Get Euler rotation of object in the ZYX intrinsic system.
  330.  * Using euler angles is discouraged, use quaternion instead.
  331.  * @method module:transform.get_rotation_euler
  332.  * @param {Object3D} obj Object 3D
  333.  * @param {Euler} [dest = new Float32Array(3)] Destination vector
  334.  * @returns {Euler} Vector with Euler angles
  335.  */
  336. exports.get_rotation_euler = function(obj, dest) {
  337.     if (!dest)
  338.         dest = new Float32Array(3);
  340.     m_trans.get_rotation_euler(obj, dest);
  341.     return dest;
  342. }
  344. /**
  345.  * Get Euler rotation of object in the ZYX intrinsic system
  346.  * (in the coordinate space of its parent).
  347.  * Using euler angles is discouraged, use quaternion instead.
  348.  * @method module:transform.get_rotation_euler
  349.  * @param {Object3D} obj Object 3D
  350.  * @param {Euler} [dest = new Float32Array(3)] Destination vector
  351.  * @returns {Euler} Vector with Euler angles
  352.  */
  353. exports.get_rotation_euler_rel = function(obj, dest) {
  354.     if (!dest)
  355.         dest = new Float32Array(3);
  357.     m_trans.get_rotation_euler_rel(obj, dest);
  358.     return dest;
  359. }
  361. /**
  362.  * Set euler rotation in the ZYX intrinsic system
  363.  * (in the coordinate space of its parent).
  364.  * Using euler angles is discouraged, use quaternion instead.
  365.  * @method module:transform.set_rotation_euler_rel
  366.  * @param {Object3D} obj Object 3D
  367.  * @param {number} x Angle X in radians
  368.  * @param {number} y Angle Y in radians
  369.  * @param {number} z Angle Z in radians
  370.  */
  371. exports.set_rotation_euler_rel = function(obj, x, y, z) {
  372.     if (m_obj_util.is_dynamic(obj)) {
  373.         _vec3_tmp[0] = x;
  374.         _vec3_tmp[1] = y;
  375.         _vec3_tmp[2] = z;
  377.         m_trans.set_rotation_euler_rel(obj, _vec3_tmp);
  378.         m_trans.update_transform(obj);
  379.         m_phy.sync_transform(obj);
  380.     } else
  381.         m_print.error("Wrong object: \"" + obj.name + "\" is not dynamic.");
  382. }
  384. /**
  385.  * Set euler rotation in vector form.
  386.  * Using euler angles is discouraged, use quaternion instead.
  387.  * @method module:transform.set_rotation_euler_v
  388.  * @param {Object3D} obj Object 3D
  389.  * @param {Euler} euler Vector with euler angles
  390.  */
  391. exports.set_rotation_euler_v = function(obj, euler) {
  392.     if (m_obj_util.is_dynamic(obj)) {
  393.         m_trans.set_rotation_euler(obj, euler);
  394.         m_trans.update_transform(obj);
  395.         m_phy.sync_transform(obj);
  396.     } else
  397.         m_print.error("Wrong object: \"" + obj.name + "\" is not dynamic.");
  398. }
  400. /**
  401.  * Set euler rotation in vector form relatively to its parent
  402.  * (in the coordinate space of its parent).
  403.  * Using euler angles is discouraged, use quaternion instead.
  404.  * @method module:transform.set_rotation_euler_rel_v
  405.  * @param {Object3D} obj Object 3D
  406.  * @param {Euler} euler Vector with euler angles
  407.  */
  408. exports.set_rotation_euler_rel_v = function(obj, euler) {
  409.     if (m_obj_util.is_dynamic(obj)) {
  410.         m_trans.set_rotation_euler_rel(obj, euler);
  411.         m_trans.update_transform(obj);
  412.         m_phy.sync_transform(obj);
  413.     } else
  414.         m_print.error("Wrong object: \"" + obj.name + "\" is not dynamic.");
  415. }
  417. /**
  418.  * Set the object scale.
  419.  * @method module:transform.set_scale
  420.  * @param {Object3D} obj Object 3D
  421.  * @param {number} scale Object scale
  422.  */
  423. exports.set_scale = function(obj, scale) {
  424.     if (m_obj_util.is_dynamic(obj)) {
  425.         m_trans.set_scale(obj, scale);
  426.         m_trans.update_transform(obj);
  427.     } else
  428.         m_print.error("Wrong object: \"" + obj.name + "\" is not dynamic.");
  429. }
  431. /**
  432.  * Set the object's scale
  433.  * (in the coordinate space of its parent).
  434.  * @method module:transform.set_scale_rel
  435.  * @param {Object3D} obj Object 3D
  436.  * @param {number} scale Object scale
  437.  */
  438. exports.set_scale_rel = function(obj, scale) {
  439.     if (m_obj_util.is_dynamic(obj)) {
  440.         m_trans.set_scale_rel(obj, scale);
  441.         m_trans.update_transform(obj);
  442.     } else
  443.         m_print.error("Wrong object: \"" + obj.name + "\" is not dynamic.");
  444. }
  446. /**
  447.  * Get the object scale.
  448.  * @method module:transform.get_scale
  449.  * @param {Object3D} obj Object 3D
  450.  * @returns {number} scale
  451.  */
  452. exports.get_scale = function(obj) {
  453.     return m_trans.get_scale(obj);
  454. }
  456. /**
  457.  * Get the object scale
  458.  * (in the coordinate space of its parent).
  459.  * @method module:transform.get_scale_rel
  460.  * @param {Object3D} obj Object 3D
  461.  * @returns {number} scale
  462.  */
  463. exports.get_scale_rel = function(obj) {
  464.     return m_trans.get_scale_rel(obj);
  465. }
  467. /**
  468.  * Reset EMPTY's transform to allow child objects behave in the absolute (world) space.
  469.  * @method module:transform.empty_reset_transform
  470.  * @param {Object3D} obj Object 3D
  471.  */
  472. exports.empty_reset_transform = function(obj) {
  473.     if (obj.type != "EMPTY") {
  474.         m_print.error("Wrong object: " + obj.name);
  475.         return;
  476.     }
  478.     for (var i = 0; i < obj.cons_descends.length; i++)
  479.         if (!m_obj_util.is_dynamic(obj.cons_descends[i])) {
  480.             m_print.error("Wrong object: \"" + obj.cons_descends[i].name 
  481.                     + "\" is not dynamic.");
  482.             return;
  483.         }
  485.     m_trans.set_translation(obj, [0, 0, 0]);
  486.     m_trans.set_rotation(obj, [0, 0, 0, 1]);
  487.     m_trans.set_scale(obj, 1);
  488.     m_trans.update_transform(obj);
  489.     m_phy.sync_transform(obj);
  490. }
  492. /**
  493.  * Get object size (maximum radius, calculated from bounding box).
  494.  * @method module:transform.get_object_size
  495.  * @param {Object3D} obj Object 3D
  496.  * @returns {number} Object size
  497.  */
  498. exports.get_object_size = function(obj) {
  500.     if (!m_obj_util.is_mesh(obj)) {
  501.         m_print.error("Wrong object: " + obj.name);
  502.         return 0;
  503.     }
  505.     return m_trans.get_object_size(obj);
  506. }
  507. /**
  508.  * Get the object center in the world space.
  509.  * Works for dynamic and static objects.
  510.  * @method module:transform.get_object_center
  511.  * @param {Object3D} obj Object 3D
  512.  * @param {boolean} calc_bs_center Use the object's bounding sphere to
  513.  * calculate center, otherwise use the bounding box.
  514.  * @param {Vec3} [dest] Destination vector
  515.  * @returns {Vec3} Destination vector
  516.  */
  517. exports.get_object_center = function(obj, calc_bs_center, dest) {
  519.     if (!m_obj_util.is_mesh(obj)) {
  520.         m_print.error("Wrong object: " + obj.name);
  521.         return null;
  522.     }
  524.     if (!dest)
  525.         dest = new Float32Array(3);
  527.     return m_trans.get_object_center(obj, calc_bs_center, dest);
  528. }
  530. /**
  531.  * Perform incremental object translation in the local space.
  532.  * @method module:transform.move_local
  533.  * @param {Object3D} obj Object 3D
  534.  * @param {number} dx Translation offset along X axis
  535.  * @param {number} dy Translation offset along Y axis
  536.  * @param {number} dz Translation offset along Z axis
  537.  */
  538. exports.move_local = function(obj, dx, dy, dz) {
  539.     if (m_obj_util.is_dynamic(obj)) {
  540.         m_trans.move_local(obj, dx, dy, dz);
  541.         m_trans.update_transform(obj);
  542.         m_phy.sync_transform(obj);
  543.     } else
  544.         m_print.error("Wrong object: \"" + obj.name + "\" is not dynamic.");
  545. }
  547. /**
  548.  * Perform incremental rotation around X axis in the local space.
  549.  * @method module:transform.rotate_x_local
  550.  * @param {Object3D} obj Object 3D
  551.  * @param {number} angle Angle in radians
  552.  */
  553. exports.rotate_x_local = function(obj, angle) {
  554.     if (m_obj_util.is_dynamic(obj)) {
  555.         var quat = m_quat.setAxisAngle(m_util.AXIS_X, angle, _quat4_tmp);
  556.         m_trans.rotate_local(obj, quat);
  557.         m_trans.update_transform(obj);
  558.         m_phy.sync_transform(obj);
  559.     } else
  560.         m_print.error("Wrong object: \"" + obj.name + "\" is not dynamic.");
  561. }
  563. /**
  564.  * Perform incremental rotation around Y axis in the local space.
  565.  * @method module:transform.rotate_y_local
  566.  * @param {Object3D} obj Object 3D
  567.  * @param {number} angle Angle in radians
  568.  */
  569. exports.rotate_y_local = function(obj, angle) {
  570.     if (m_obj_util.is_dynamic(obj)) {
  571.         var quat = m_quat.setAxisAngle(m_util.AXIS_MY, angle, _quat4_tmp);
  572.         m_trans.rotate_local(obj, quat);
  573.         m_trans.update_transform(obj);
  574.         m_phy.sync_transform(obj);
  575.     } else
  576.         m_print.error("Wrong object: \"" + obj.name + "\" is not dynamic.");
  577. }
  579. /**
  580.  * Perform incremental rotation around Z axis in the local space.
  581.  * @method module:transform.rotate_z_local
  582.  * @param {Object3D} obj Object 3D
  583.  * @param {number} angle Angle in radians
  584.  */
  585. exports.rotate_z_local = function(obj, angle) {
  586.     if (m_obj_util.is_dynamic(obj)) {
  587.         var quat = m_quat.setAxisAngle(m_util.AXIS_Z, angle, _quat4_tmp);
  588.         m_trans.rotate_local(obj, quat);
  589.         m_trans.update_transform(obj);
  590.         m_phy.sync_transform(obj);
  591.     } else
  592.         m_print.error("Wrong object: \"" + obj.name + "\" is not dynamic.");
  593. }
  595. /**
  596.  * Get object bounding box.
  597.  * @method module:transform.get_object_bounding_box
  598.  * @param {Object3D} obj Object 3D
  599.  * @returns {BoundingBox} Bounding box
  600.  * @cc_externs max_x min_x max_y min_y max_z min_z
  601.  */
  602. exports.get_object_bounding_box = function(obj) {
  603.     return m_bounds.clone_bb(obj.render.bb_world);
  604. }
  606. /**
  607.  * Set the object's TSR vector.
  608.  * @method module:transform.set_tsr
  609.  * @param {Object3D} obj Object 3D
  610.  * @param {TSR} tsr vector
  611.  */
  612. exports.set_tsr = function(obj, tsr) {
  613.     if (m_obj_util.is_dynamic(obj)) {
  614.         m_trans.set_tsr(obj, tsr);
  615.         m_trans.update_transform(obj);
  616.         m_phy.sync_transform(obj);
  617.     } else
  618.         m_print.error("Wrong object: \"" + obj.name + "\" is not dynamic.");
  619. }
  621. /**
  622.  * Set the object's TSR vector
  623.  * (in the coordinate space of its parent).
  624.  * @method module:transform.set_tsr_rel
  625.  * @param {Object3D} obj Object 3D
  626.  * @param {TSR} tsr vector
  627.  */
  628. exports.set_tsr_rel = function(obj, tsr) {
  629.     if (m_obj_util.is_dynamic(obj)) {
  630.         m_trans.set_tsr_rel(obj, tsr);
  631.         m_trans.update_transform(obj);
  632.         m_phy.sync_transform(obj);
  633.     } else
  634.         m_print.error("Wrong object: \"" + obj.name + "\" is not dynamic.");
  635. }
  637. /**
  638.  * Return an object's transformation in TSR form.
  639.  * @method module:transform.get_tsr
  640.  * @param {Object3D} obj Object 3D
  641.  * @param {TSR} [dest] Destination vector.
  642.  * @returns {TSR} Destination vector.
  643.  */
  644. exports.get_tsr = function(obj, dest) {
  645.     if (!dest)
  646.         dest = new Float32Array(8);
  648.     m_trans.get_tsr(obj, dest);
  650.     return dest;
  651. }
  653. /**
  654.  * Return the object transformation in TSR form.
  655.  * (in the coordinate space of its parent).
  656.  * @method module:transform.get_tsr_rel
  657.  * @param {Object3D} obj Object 3D
  658.  * @param {TSR} [dest] Destination vector.
  659.  * @returns {TSR} Destination vector.
  660.  */
  661. exports.get_tsr_rel = function(obj, dest) {
  662.     if (!dest)
  663.         dest = new Float32Array(8);
  665.     m_trans.get_tsr_rel(obj, dest);
  667.     return dest;
  668. }
  670. /**
  671.  * Get distance between the two objects.
  672.  * @method module:transform.distance
  673.  * @param {Object3D} obj1 The first object.
  674.  * @param {Object3D} obj2 The second object.
  675.  * @returns {number} Distance
  676.  */
  677. exports.distance = function(obj1, obj2) {
  678.     return m_trans.distance(obj1, obj2);
  679. }
  681. /**
  682.  * Set the object's transformation matrix.
  683.  * It's better to use TSR form.
  684.  * @method module:transform.set_matrix
  685.  * @param {Object3D} obj Object 3D
  686.  * @param {Mat4} mat Matrix
  687.  */
  688. exports.set_matrix = function(obj, mat) {
  689.     if (m_obj_util.is_dynamic(obj)) {
  690.         m_tsr.from_mat4(mat, _tsr_tmp);
  691.         m_trans.set_tsr(obj, _tsr_tmp);
  692.         m_trans.update_transform(obj);
  693.         m_phy.sync_transform(obj);
  694.     } else
  695.         m_print.error("Wrong object: \"" + obj.name + "\" is not dynamic.");
  696. }
  698. /**
  699.  * Set the object's transformation matrix
  700.  * (in the coordinate space of its parent).
  701.  * It's better to use TSR form.
  702.  * @method module:transform.set_matrix_rel
  703.  * @param {Object3D} obj Object 3D
  704.  * @param {Mat4} mat Matrix
  705.  */
  706. exports.set_matrix_rel = function(obj, mat) {
  707.     if (m_obj_util.is_dynamic(obj)) {
  708.         m_tsr.from_mat4(mat, _tsr_tmp);
  709.         m_trans.set_tsr_rel(obj, _tsr_tmp);
  710.         m_trans.update_transform(obj);
  711.         m_phy.sync_transform(obj);
  712.     } else
  713.         m_print.error("Wrong object: \"" + obj.name + "\" is not dynamic.");
  714. }
  716. /**
  717.  * Return the object's transformation matrix.
  718.  * It's better to use TSR form.
  719.  * @method module:transform.get_matrix
  720.  * @param {Object3D} obj Object 3D
  721.  * @param {Mat4} [dest] Destination matrix.
  722.  * @returns {Mat4} Destination matrix.
  723.  */
  724. exports.get_matrix = function(obj, dest) {
  725.     if (!dest)
  726.         dest = new Float32Array(16);
  728.     m_trans.get_tsr(obj, _tsr_tmp);
  729.     m_tsr.to_mat4(_tsr_tmp, dest);
  731.     return dest;
  732. }
  734. /**
  735.  * Return the object's transformation matrix
  736.  * (in the coordinate space of its parent).
  737.  * It's better to use TSR form.
  738.  * @method module:transform.get_matrix_rel
  739.  * @param {Object3D} obj Object 3D
  740.  * @param {Mat4} [dest] Destination matrix.
  741.  * @returns {Mat4} Destination matrix.
  742.  */
  743. exports.get_matrix_rel = function(obj, dest) {
  744.     if (!dest)
  745.         dest = new Float32Array(16);
  747.     m_trans.get_tsr_rel(obj, _tsr_tmp);
  748.     m_tsr.to_mat4(_tsr_tmp, dest);
  750.     return dest;
  751. }
  753. }
  755. var transform_factory = register("transform", Transform);
  757. export default transform_factory;