Source: extern/animation.js

  1. import register from "../util/register.js";
  3. import m_anim_fact from "../intern/animation.js";
  4. import m_obj_util_fact from "../intern/obj_util.js";
  5. import m_print_fact from "../intern/print.js";
  7. /**
  8.  * API methods for animation.
  9.  * @see https://www.blend4web.com/doc/en/animation.html
  10.  * @module animation
  11.  * @local AnimFinishCallback
  12.  * @local AnimBehavior
  13.  * @local AnimType
  14.  * @local AnimSlot
  15.  */
  16. function Animation(ns, exports) {
  18. var m_anim  = m_anim_fact(ns);
  19. var m_obj_util = m_obj_util_fact(ns);
  20. var m_print = m_print_fact(ns);
  22. /**
  23.  * Animation finish callback.
  24.  * @callback AnimFinishCallback
  25.  * @param {Object3D} obj Animated object.
  26.  * @param {AnimSlot} slot_num Animation slot.
  27.  */
  29. /**
  30.  * Animation blending finish callback.
  31.  * @callback AnimBlendingCallback
  32.  */
  34. /**
  35.  * Animation behavior enum.
  36.  * @see {@link module:animation.AB_CYCLIC},
  37.  * {@link module:animation.AB_FINISH_RESET},
  38.  * {@link module:animation.AB_FINISH_STOP}
  39.  * @typedef {number} AnimBehavior
  40.  */
  42. /**
  43.  * Animation type enum. One of OBJ_ANIM_TYPE_*.
  44.  * @typedef {number} AnimType
  45.  */
  47. /**
  48.  * Animation slot enum. One of SLOT_*.
  49.  * @typedef {number} AnimSlot
  50.  */
  52. /**
  53.  * Object's animation slot 0.
  54.  * @const {AnimSlot} module:animation.SLOT_0
  55.  */
  56. exports.SLOT_0   = m_anim.SLOT_0;
  58. /**
  59.  * Object's animation slot 1.
  60.  * @const {AnimSlot} module:animation.SLOT_1
  61.  */
  62. exports.SLOT_1   = m_anim.SLOT_1;
  64. /**
  65.  * Object's animation slot 2.
  66.  * @const {AnimSlot} module:animation.SLOT_2
  67.  */
  68. exports.SLOT_2   = m_anim.SLOT_2;
  70. /**
  71.  * Object's animation slot 3.
  72.  * @const {AnimSlot} module:animation.SLOT_3
  73.  */
  74. exports.SLOT_3   = m_anim.SLOT_3;
  76. /**
  77.  * Object's animation slot 4.
  78.  * @const {AnimSlot} module:animation.SLOT_4
  79.  */
  80. exports.SLOT_4   = m_anim.SLOT_4;
  82. /**
  83.  * Object's animation slot 5.
  84.  * @const {AnimSlot} module:animation.SLOT_5
  85.  */
  86. exports.SLOT_5   = m_anim.SLOT_5;
  88. /**
  89.  * Object's animation slot 6.
  90.  * @const {AnimSlot} module:animation.SLOT_6
  91.  */
  92. exports.SLOT_6   = m_anim.SLOT_6;
  94. /**
  95.  * Object's animation slot 7.
  96.  * @const {AnimSlot} module:animation.SLOT_7
  97.  */
  98. exports.SLOT_7   = m_anim.SLOT_7;
  100. /**
  101.  * All object's animation slots.
  102.  * @const {AnimSlot} module:animation.SLOT_ALL
  103.  */
  104. exports.SLOT_ALL = m_anim.SLOT_ALL;
  106. /**
  107.  * Animation type: none.
  108.  * @const {AnimType} module:animation.OBJ_ANIM_TYPE_NONE
  109.  */
  110. exports.OBJ_ANIM_TYPE_NONE      = m_anim.OBJ_ANIM_TYPE_NONE;
  112. /**
  113.  * Animation type: armature.
  114.  * @const {AnimType} module:animation.OBJ_ANIM_TYPE_ARMATURE
  115.  */
  116. exports.OBJ_ANIM_TYPE_ARMATURE  = m_anim.OBJ_ANIM_TYPE_ARMATURE;
  118. /**
  119.  * Animation type: object.
  120.  * @const {AnimType} module:animation.OBJ_ANIM_TYPE_OBJECT
  121.  */
  122. exports.OBJ_ANIM_TYPE_OBJECT    = m_anim.OBJ_ANIM_TYPE_OBJECT;
  124. /**
  125.  * Animation type: vertex.
  126.  * @const {AnimType} module:animation.OBJ_ANIM_TYPE_VERTEX
  127.  */
  128. exports.OBJ_ANIM_TYPE_VERTEX    = m_anim.OBJ_ANIM_TYPE_VERTEX;
  130. /**
  131.  * Animation type: sound.
  132.  * @const {AnimType} module:animation.OBJ_ANIM_TYPE_SOUND
  133.  */
  134. exports.OBJ_ANIM_TYPE_SOUND     = m_anim.OBJ_ANIM_TYPE_SOUND;
  136. /**
  137.  * Animation type: particles.
  138.  * @const {AnimType} module:animation.OBJ_ANIM_TYPE_PARTICLES
  139.  */
  140. exports.OBJ_ANIM_TYPE_PARTICLES = m_anim.OBJ_ANIM_TYPE_PARTICLES;
  142. /**
  143.  * Animation type: material.
  144.  * @const {AnimType} module:animation.OBJ_ANIM_TYPE_MATERIAL
  145.  */
  146. exports.OBJ_ANIM_TYPE_MATERIAL  = m_anim.OBJ_ANIM_TYPE_MATERIAL;
  148. /**
  149.  * Animation type: static.
  150.  * @const {AnimType} module:animation.OBJ_ANIM_TYPE_STATIC
  151.  */
  152. exports.OBJ_ANIM_TYPE_STATIC    = m_anim.OBJ_ANIM_TYPE_STATIC;
  154. /**
  155.  * Animation behavior: cyclic.
  156.  * @const {AnimBehavior} module:animation.AB_CYCLIC
  157.  */
  158. exports.AB_CYCLIC = m_anim.AB_CYCLIC;
  159. /**
  160.  * Animation behavior: go back to the zero frame after finishing.
  161.  * @const {AnimBehavior} module:animation.AB_FINISH_RESET
  162.  */
  163. exports.AB_FINISH_RESET = m_anim.AB_FINISH_RESET;
  164. /**
  165.  * Animation behavior: stop the animation after finishing.
  166.  * @const {AnimBehavior} module:animation.AB_FINISH_STOP
  167.  */
  168. exports.AB_FINISH_STOP = m_anim.AB_FINISH_STOP;
  170. /**
  171.  * Check if the object is animated.
  172.  * @method module:animation.is_animated
  173.  * @param {Object3D} obj Object 3D
  174.  * @returns {boolean} Checking result.
  175.  */
  176. exports.is_animated = function(obj) {
  177.     return m_anim.is_animated(obj);
  178. }
  180. /**
  181.  * Return the names of all available animations.
  182.  * @method module:animation.get_anim_names
  183.  * @param {Object3D} obj Object 3D
  184.  * @returns {string[]} Array of animation names.
  185.  */
  186. exports.get_anim_names = function(obj) {
  187.     if (!m_anim.obj_is_animatable(obj))
  188.         return [];
  190.     return m_anim.get_anim_names(obj);
  191. }
  193. /**
  194.  * Return the name of the applied animation.
  195.  * @method module:animation.get_current_anim_name
  196.  * @param {Object3D} obj Object 3D
  197.  * @param {AnimSlot} [slot_num = SLOT_0] Animation slot number
  198.  * @returns {?string} Current animation name or null.
  199.  */
  200. exports.get_current_anim_name = function(obj, slot_num) {
  201.     if (!m_anim.is_animated(obj))
  202.         return null;
  204.     slot_num = slot_num || m_anim.SLOT_0;
  205.     return m_anim.get_anim_by_slot_num(obj, slot_num);
  206. }
  208. /**
  209.  * Apply the animation to the object.
  210.  * @method module:animation.apply
  211.  * @param {Object3D} obj Object 3D
  212.  * @param {string} name Animation name
  213.  * @param {AnimSlot} [slot_num = SLOT_0] Animation slot number.
  214.  */
  215. exports.apply = function(obj, name, slot_num) {
  216.     if (slot_num > m_anim.SLOT_7) {
  217.         m_print.error("Can't apply animation to slot " + slot_num +
  218.                       " for object \"" + obj.name +
  219.                       "\". Object can have maximum of 8 animation slots");
  220.         return;
  221.     }
  222.     slot_num = slot_num || m_anim.SLOT_0;
  224.     if (m_anim.is_animated(obj)) {
  225.         var applied_slot = m_anim.get_slot_num_by_anim(obj, name);
  226.         if (applied_slot != -1 && applied_slot != slot_num) {
  227.             m_print.error("Animation \"" + name +
  228.                           "\" is already applied to object \"" + obj.name +
  229.                           "\" (slot \"" + applied_slot + "\").");
  230.             return;
  231.         }
  232.     }
  234.     if (!m_anim.validate_action_by_name(obj, name)) {
  235.         m_print.error("No fcurves in action \"" + name + "\"");
  236.         return;
  237.     }
  239.     m_anim.apply(obj, null, name, slot_num);
  240. }
  242. /**
  243.  * Apply the animation to the object.
  244.  * @method module:animation.apply_ext
  245.  * @param {Object3D} obj Object 3D
  246.  * @param {?String[]} name_list Array of material and nested groups names and
  247.  * animation name.
  248.  * @param {AnimSlot} [slot_num = SLOT_0] Animation slot number.
  249.  */
  250. exports.apply_ext = function(obj, name_list, slot_num) {
  251.     if (slot_num > m_anim.SLOT_7) {
  252.         m_print.error("Can't apply animation to slot " + slot_num +
  253.                       " for object \"" + obj.name +
  254.                       "\". Object can have maximum of 8 animation slots");
  255.         return;
  256.     }
  257.     slot_num = slot_num || m_anim.SLOT_0;
  259.     var name = name_list[0];
  261.     if (!m_anim.validate_action_by_name(obj, name)) {
  262.         m_print.error("No fcurves in action \"" + name + "\"");
  263.         return;
  264.     }
  265.     var new_name_list = name_list.slice(1);
  267.     m_anim.apply(obj, new_name_list, name, slot_num);
  268. }
  270. /**
  271.  * Remove the animation from the object.
  272.  * @method module:animation.remove
  273.  * @param {Object3D} obj Object 3D
  274.  */
  275. exports.remove = function(obj) {
  276.     m_anim.remove(obj);
  277. }
  279. /**
  280.  * Remove the animation from the given animation slot of the object.
  281.  * @method module:animation.remove_slot_animation
  282.  * @param {Object3D} obj Object 3D
  283.  * @param {AnimSlot} [slot_num = SLOT_0] Animation slot number.
  284.  */
  285. exports.remove_slot_animation = function(obj, slot_num) {
  286.     if (!m_anim.is_animated(obj))
  287.         return;
  289.     slot_num = slot_num || m_anim.SLOT_0;
  290.     m_anim.remove_slot_animation(obj, slot_num);
  291. }
  293. /**
  294.  * Apply the default animation (i.e. assigned in Blender) to the object.
  295.  * @method module:animation.apply_def
  296.  * @param {Object3D} obj Object 3D
  297.  */
  298. exports.apply_def = function(obj) {
  299.     m_anim.apply_def(obj);
  300. }
  302. /**
  303.  * Play the object's animation. 
  304.  * The animation must be applied to the object before,
  305.  * or the object must have the default animation (i.e. assigned in Blender).
  306.  * @method module:animation.play
  307.  * @param {Object3D} obj Object 3D
  308.  * @param {AnimFinishCallback} [finish_callback] Callback to execute on finished animation
  309.  * @param {AnimSlot} [slot_num = SLOT_0] Animation slot number.
  310.  */
  311. exports.play = function(obj, finish_callback, slot_num) {
  312.     if (!m_anim.is_animated(obj)) {
  313.         m_print.error("Object \"" + obj.name + "\" has no applied animation");
  314.         return;
  315.     }
  317.     slot_num = slot_num || m_anim.SLOT_0;
  318.     m_anim.play(obj, finish_callback, slot_num);
  319.     m_anim.update_object_animation(obj, 0, slot_num, true);
  320. }
  322. /**
  323.  * Stop the object's animation.
  324.  * @method module:animation.stop
  325.  * @param {Object3D} obj Object 3D
  326.  * @param {AnimSlot} [slot_num = SLOT_0] Animation slot number
  327.  */
  328. exports.stop = function(obj, slot_num) {
  329.     if (m_anim.is_animated(obj)) {
  330.         slot_num = slot_num || m_anim.SLOT_0;
  331.         m_anim.stop(obj, slot_num);
  332.     }
  333. }
  334. /**
  335.  * Check if the object's animation is being played back.
  336.  * @method module:animation.is_play
  337.  * @param {Object3D} obj Object 3D
  338.  * @param {AnimSlot} [slot_num = SLOT_0] Animation slot number
  339.  * @returns {boolean} Checking result.
  340.  */
  341. exports.is_play = function(obj, slot_num) {
  342.     if (!m_anim.is_animated(obj))
  343.         return false;
  345.     slot_num = slot_num || m_anim.SLOT_0;
  346.     return m_anim.is_play(obj, slot_num);
  347. }
  349. /**
  350.  * Set the current frame of the object's animation.
  351.  * @method module:animation.set_frame
  352.  * @param {Object3D} obj Object 3D
  353.  * @param {number} frame Current frame (float)
  354.  * @param {AnimSlot} [slot_num = SLOT_0] Animation slot number
  355.  */
  356. exports.set_frame = function(obj, frame, slot_num) {
  357.     if (!m_anim.is_animated(obj))
  358.         return;
  360.     slot_num = slot_num || m_anim.SLOT_0;
  361.     m_anim.set_frame(obj, frame, slot_num);
  362. }
  364. /**
  365.  * Set the first frame of the object's animation.
  366.  * @method module:animation.set_first_frame
  367.  * @param {Object3D} obj Object 3D
  368.  * @param {AnimSlot} [slot_num = SLOT_0] Animation slot number
  369.  */
  370. exports.set_first_frame = function(obj, slot_num) {
  371.     if (!m_anim.is_animated(obj))
  372.         return;
  373.     m_anim.set_first_frame(obj, slot_num);
  374. }
  376. /**
  377.  * Set the last frame of the object's animation.
  378.  * @method module:animation.set_last_frame
  379.  * @param {Object3D} obj Object 3D
  380.  * @param {AnimSlot} [slot_num = SLOT_0] Animation slot number
  381.  */
  382. exports.set_last_frame = function(obj, slot_num) {
  383.     if (!m_anim.is_animated(obj))
  384.         return;
  386.     slot_num = slot_num || m_anim.SLOT_0;
  388.     var start = m_anim.get_anim_start_frame(obj, slot_num);
  389.     var len = m_anim.get_anim_length(obj, slot_num);
  391.     m_anim.set_frame(obj, start + len -
  392.             m_anim.LAST_FRAME_EPSILON, slot_num);
  393. }
  395. /**
  396.  * Get the current frame of the object's animation.
  397.  * @method module:animation.get_frame
  398.  * @param {Object3D} obj Object 3D
  399.  * @param {AnimSlot} [slot_num = SLOT_0] Animation slot number
  400.  * @returns {number} Current frame
  401.  */
  402. exports.get_frame = function(obj, slot_num) {
  403.     if (!m_anim.is_animated(obj))
  404.         return 0.0;
  406.     slot_num = slot_num || m_anim.SLOT_0;
  407.     return m_anim.get_current_frame_float(obj, slot_num);
  408. }
  410. /**
  411.  * Set the speed of the object's animation.
  412.  * @method module:animation.set_speed
  413.  * @param {Object3D} obj Object 3D
  414.  * @param {number} speed Speed (may be negative) (float)
  415.  * @param {AnimSlot} [slot_num = SLOT_0] Animation slot number
  416.  */
  417. exports.set_speed = function(obj, speed, slot_num) {
  418.     if (!m_anim.is_animated(obj))
  419.         return;
  421.     slot_num = slot_num || m_anim.SLOT_0;
  422.     speed = speed || 1;
  423.     m_anim.set_speed(obj, speed, slot_num);
  424. }
  426. /**
  427.  * Get the speed of the object's animation.
  428.  * @method module:animation.get_speed
  429.  * @param {Object3D} obj Object 3D
  430.  * @param {AnimSlot} [slot_num = SLOT_0] Animation slot number
  431.  * @returns {number} Animation speed.
  432.  */
  433. exports.get_speed = function(obj, slot_num) {
  434.     if (!m_anim.is_animated(obj))
  435.         return 0;
  437.     slot_num = slot_num || m_anim.SLOT_0;
  439.     if (!obj.anim_slots[slot_num])
  440.         return 0;
  442.     return m_anim.get_speed(obj, slot_num);
  443. }
  445. /**
  446.  * Get the starting frame of the object's animation.
  447.  * @method module:animation.get_anim_start_frame
  448.  * @param {Object3D} obj Object 3D
  449.  * @param {AnimSlot} [slot_num = SLOT_0] Animation slot number
  450.  * @returns {number} Animation start frame or -1 for incorrect object
  451.  */
  452. exports.get_anim_start_frame = function(obj, slot_num) {
  453.     if (m_anim.is_animated(obj)) {
  454.         slot_num = slot_num || m_anim.SLOT_0;
  456.         if (!obj.anim_slots[slot_num])
  457.             return -1;
  458.         else
  459.             return m_anim.get_anim_start_frame(obj, slot_num);
  460.     }
  462.     return -1;
  463. }
  465. /**
  466.  * Get the length of the object's animation measured in frames.
  467.  * @method module:animation.get_anim_length
  468.  * @param {Object3D} obj Object 3D
  469.  * @param {AnimSlot} [slot_num = SLOT_0] Animation slot number
  470.  * @returns {number} Animation length or -1 for incorrect object
  471.  */
  472. exports.get_anim_length = function(obj, slot_num) {
  473.     if (m_anim.is_animated(obj)) {
  474.         slot_num = slot_num || m_anim.SLOT_0;
  476.         if (!obj.anim_slots[slot_num])
  477.             return -1;
  478.         else
  479.             return m_anim.get_anim_length(obj, slot_num);
  480.     }
  482.     return -1;
  483. }
  485. /**
  486.  * Set behavior for the object's animation.
  487.  * @method module:animation.set_behavior
  488.  * @param {Object3D} obj Object 3D
  489.  * @param {AnimBehavior} behavior Behavior enum
  490.  * @param {AnimSlot} [slot_num = SLOT_0] Animation slot number
  491.  */
  492. exports.set_behavior = function(obj, behavior, slot_num) {
  493.     if (!m_anim.is_animated(obj))
  494.         return;
  496.     slot_num = slot_num || m_anim.SLOT_0;
  497.     m_anim.set_behavior(obj, behavior, slot_num);
  498. }
  500. /**
  501.  * Get behavior of the object's animation.
  502.  * @method module:animation.get_behavior
  503.  * @param {Object3D} obj Object 3D
  504.  * @param {AnimSlot} [slot_num = SLOT_0] Animation slot number
  505.  * @returns {AnimBehavior} Behavior enum
  506.  */
  507. exports.get_behavior = function(obj, slot_num) {
  508.     if (!m_anim.is_animated(obj))
  509.         return null;
  511.     slot_num = slot_num || m_anim.SLOT_0;
  512.     return m_anim.get_behavior(obj, slot_num);
  513. }
  515. /**
  516.  * Apply smoothing to the object's animation.
  517.  * In order to disable the smoothing, specify the zero periods.
  518.  * @method module:animation.apply_smoothing
  519.  * @param {Object3D} obj Object 3D
  520.  * @param {number} [trans_period=0] Translation smoothing period
  521.  * @param {number} [quat_period=0] Rotation smoothing period
  522.  * @param {AnimSlot} [slot_num = SLOT_0] Animation slot number
  523.  */
  524. exports.apply_smoothing = function(obj, trans_period, quat_period, slot_num) {
  525.     slot_num = slot_num || m_anim.SLOT_0;
  526.     if (m_anim.is_animated(obj))
  527.         m_anim.apply_smoothing(obj, trans_period, quat_period, slot_num);
  528. }
  530. /**
  531.  * Convert animation frames to seconds.
  532.  * @method module:animation.frame_to_sec
  533.  * @param {number} frame Frame number
  534.  * @returns {number} Number of seconds
  535.  */
  536. exports.frame_to_sec = function(frame) {
  537.     return m_anim.frame_to_sec(frame);
  538. }
  540. /**
  541.  * Get the slot number of the object to which the animation is assigned.
  542.  * @method module:animation.get_slot_num_by_anim
  543.  * @param {Object3D} obj Object 3D
  544.  * @param {string} anim_name Animation name
  545.  * @returns {?number} Animation slot number
  546.  */
  547. exports.get_slot_num_by_anim = function(obj, anim_name) {
  548.     if (!m_anim.is_animated(obj) || !anim_name)
  549.         return -1;
  551.     return m_anim.get_slot_num_by_anim(obj, anim_name);
  552. }
  554. /**
  555.  * Get the object's animation type.
  556.  * @method module:animation.get_anim_type
  557.  * @param {Object3D} obj Object 3D
  558.  * @param {AnimSlot} [slot_num = SLOT_0] Slot number
  559.  * @returns {?AnimType} Animation type
  560.  */
  561. exports.get_anim_type = function(obj, slot_num) {
  562.     if (!m_anim.is_animated(obj))
  563.         return null;
  565.     return m_anim.get_anim_type(obj, slot_num);
  566. }
  568. /**
  569.  * Apply the animation to the first available animation slot.
  570.  * @method module:animation.apply_to_first_empty_slot
  571.  * @param {Object3D} obj Object 3D
  572.  * @param {string} name Animation name.
  573.  * @returns {number} Slot number or -1 if no empty slots found.
  574.  */
  575. exports.apply_to_first_empty_slot = function(obj, name) {
  576.     return m_anim.apply_to_first_empty_slot(obj, name);
  577. }
  579. /**
  580.  * Get the mix factor for the skeletal animations assigned to the last two animation slots.
  581.  * @method module:animation.get_skel_mix_factor
  582.  * @param {Object3D} armobj Armature object.
  583.  * @returns {number} Mix factor.
  584.  */
  585. exports.get_skel_mix_factor = function(armobj) {
  586.     return armobj.render.anim_mix_factor;
  587. }
  589. /**
  590.  * Set the mix factor for the skeletal animations assigned to the last two animation slots.
  591.  * Specify the non-zero time for smooth animation transitions.
  592.  * @method module:animation.set_skel_mix_factor
  593.  * @param {Object3D} armobj Armature object.
  594.  * @param {number} factor Target animation mix factor.
  595.  * @param {number} [time=0] Time interval for changing the mix factor from
  596.  * the current to the target value.
  597.  * @param {AnimBlendingCallback} [callback=null] Callback to execute on finished blending.
  598.  */
  599. exports.set_skel_mix_factor = function(armobj, factor, time, callback) {
  600.     if (!m_obj_util.is_armature(armobj)) {
  601.         m_print.error("Can't blend animation. Object \"" + armobj.name + "\" is not armature");
  602.         return;
  603.     }
  604.     factor = Math.min(Math.max(factor, 0), 1);
  605.     if (armobj.render.anim_mix_factor == factor)
  606.         return;
  608.     time = time || 0;
  609.     callback = callback || null;
  611.     m_anim.set_skel_mix_factor(armobj, factor, time, callback);
  612. }
  613. /**
  614.  * Set the blended skeletal animation slots.
  615.  * @method module:animation.set_skeletal_slots
  616.  * @param {Object3D} armobj Armature object.
  617.  * @param {number} [slot_1=-1] First blended animation slot.
  618.  * @param {number} [slot_2=-1] Second blended animation slot.
  619.  * @param {number} [factor=0] Start animation mix factor.
  620.  */
  621. exports.set_skeletal_slots = function(armobj, slot_1, slot_2, factor) {
  622.     slot_1 = slot_1 == undefined ? -1 : slot_1;
  623.     slot_2 = slot_1 == undefined ? -1 : slot_2;
  624.     factor = factor || 0;
  625.     var render = armobj.render;
  626.     var skeletal_slots = render.blend_skel_slots;
  627.     if (slot_1 >= 0)
  628.         skeletal_slots[0] = slot_1;
  629.     if (slot_2 >= 0)
  630.         skeletal_slots[1] = slot_2;
  631.     armobj.render.anim_mix_factor = factor;
  632. }
  633. /**
  634.  * Get the first blended animation slot.
  635.  * @method module:animation.get_first_skeletal_slot
  636.  * @param {Object3D} armobj Armature object.
  637.  * @returns {slot_1} First blended animation slot.
  638.  */
  639. exports.get_first_skeletal_slot = function(armobj) {
  640.     return armobj.render.blend_skel_slots[0];
  641. }
  642. /**
  643.  * Get the second blended animation slot.
  644.  * @method module:animation.get_second_skeletal_slot
  645.  * @param {Object3D} armobj Armature object.
  646.  * @returns {slot_2} Second blended animation slot.
  647.  */
  648. exports.get_second_skeletal_slot = function(armobj) {
  649.     return armobj.render.blend_skel_slots[1];
  650. }
  651. /**
  652.  * Set the mix factor for the skeletal animations assigned to the last two animation slots.
  653.  * @method module:animation.mix_from_cur_pos
  654.  * @param {Object3D} armobj Armature object.
  655.  * @param {AnimSlot} slot Animation slot number.
  656.  * @param {number} [time=0] Time interval for changing the mix factor from
  657.  * the current to the target value.
  658.  * @param {AnimBlendingCallback} [callback=null] Callback to execute on finished blending.
  659.  */
  660. exports.mix_from_cur_pos = function(armobj, slot, time, callback) {
  661.     callback = callback || null;
  662.     time = time || 0;
  663.     m_anim.mix_from_cur_pos(armobj, slot, time, callback);
  664. }
  666. }
  668. var animation_factory = register("animation", Animation);
  670. export default animation_factory;