Source: extern/armature.js

  1. import register from "../util/register.js";
  3. import * as m_armat from "../intern/armature.js";
  4. import m_obj_util_fact from "../intern/obj_util.js";
  5. import m_trans_fact from "../intern/transform.js";
  6. import m_print_fact from "../intern/print.js";
  8. /**
  9.  * API methods to control armature objects.
  10.  * @module armature
  11.  */
  12. function Armature(ns, exports) {
  14. var m_obj_util = m_obj_util_fact(ns);
  15. var m_trans    = m_trans_fact(ns);
  16. var m_print    = m_print_fact(ns);
  18. /**
  19.  * Get translation, scale and rotation quaternion of the armature's bone,
  20.  * defined in armature space.
  21.  * @method module:armature.get_bone_tsr
  22.  * @param {Object3D} armobj Armature object
  23.  * @param {string} bone_name Bone name
  24.  * @param {TSR} [dest] Destination vector
  25.  * @returns {?TSR} Destination vector
  26.  */
  27. exports.get_bone_tsr = function(armobj, bone_name, dest) {
  28.     if (!m_obj_util.is_armature(armobj))
  29.         return null;
  31.     if (!m_armat.check_bone(armobj, bone_name)) {
  32.         m_print.error("There is no bone: \"", bone_name, "\" in \"", armobj.name, "\".");
  33.         return null;
  34.     }
  36.     if (!dest)
  37.         dest = new Float32Array(8);
  39.     m_armat.get_bone_tsr(armobj, bone_name, false, false, dest);
  40.     return dest;
  41. }
  43. /**
  44.  * Get translation, scale and rotation quaternion of the armature's bone,
  45.  * defined in parent bone space.
  46.  * @method module:armature.get_bone_tsr_rel
  47.  * @param {Object3D} armobj Armature object
  48.  * @param {string} bone_name Bone name
  49.  * @param {TSR} [dest] Destination vector
  50.  * @returns {?TSR} Destination vector
  51.  */
  52. exports.get_bone_tsr_rel = function(armobj, bone_name, dest) {
  53.     if (!m_obj_util.is_armature(armobj))
  54.         return null;
  56.     if (!m_armat.check_bone(armobj, bone_name)) {
  57.         m_print.error("There is no bone: \"", bone_name, "\" in \"", armobj.name, "\".");
  58.         return null;
  59.     }
  61.     if (!dest)
  62.         dest = new Float32Array(8);
  64.     m_armat.get_bone_tsr(armobj, bone_name, false, true, dest);
  65.     return dest;
  66. }
  68. /**
  69.  * Set translation, scale and rotation quaternion of the armature's bone,
  70.  * defined in armature space.
  71.  * @method module:armature.set_bone_tsr
  72.  * @param {Object3D} armobj Armature object
  73.  * @param {string} bone_name Bone name
  74.  * @param {TSR} tsr Translation, scale and rotation quaternion
  75.  */
  76. exports.set_bone_tsr = function(armobj, bone_name, tsr) {
  77.     if (!m_obj_util.is_armature(armobj))
  78.         return;
  80.     if (!m_armat.check_bone(armobj, bone_name)) {
  81.         m_print.error("There is no bone: \"", bone_name, "\" in \"", armobj.name, "\".");
  82.         return;
  83.     }
  85.     m_armat.set_bone_tsr(armobj, bone_name, tsr, false);
  86.     m_trans.update_transform(armobj);
  87. }
  89. /**
  90.  * Set translation, scale and rotation quaternion of the armature's bone,
  91.  * defined in parent bone space.
  92.  * @method module:armature.set_bone_tsr_rel
  93.  * @param {Object3D} armobj Armature object
  94.  * @param {string} bone_name Bone name
  95.  * @param {TSR} tsr Translation, scale and rotation quaternion
  96.  */
  97. exports.set_bone_tsr_rel = function(armobj, bone_name, tsr) {
  98.     if (!m_obj_util.is_armature(armobj))
  99.         return;
  101.     if (!m_armat.check_bone(armobj, bone_name)) {
  102.         m_print.error("There is no bone: \"", bone_name, "\" in \"", armobj.name, "\".");
  103.         return;
  104.     }
  106.     m_armat.set_bone_tsr(armobj, bone_name, tsr, true);
  107.     m_trans.update_transform(armobj);
  108. }
  110. }
  112. var armature_factory = register("armature", Armature);
  114. export default armature_factory;