Motion Output Parameter List

last revision on Sept 29 2021 

This document is a detailed list of the motion output parameters available to you, the avatar creator for custom-animating your avatars in Animaze. You will likely want to refer to this list to custom-map aspects like Hand Motion from Ultraleap (Leap Motion) on your custom Live2D avatar (and more). 

Depending on the animation standard and avatar technology you use, all (or just some) of the output parameters listed below will be auto-mapped to your avatar’s available motion inputs - the inputs that you have built and surfaced in your avatar.  

If you want more control and do not want to use the automatic mapping, you’ll want to use the list below and the Retargeting Overrides in the Animaze Editor to make your own custom choices. 

Please note that the motion output parameter list below (long as it may be), is a simplification of all the total data Animaze normally gets from the tracker modules. This is why more complex aspects (especially the ones related to full-body motion capture retargeting on full 3D avatars) will only be achievable with high accuracy with automatic mapping.

The current auto-presets per type of avatar technology are:

For Live2d avatars in Animaze 

  • Default Animation Standard (simpler, most used currently)

  • Extended Animation Standard (more complex)

For VRM avatars in Animaze you have

  • VRoid VRM Animation Standard (simpler)

  • Perfect Sync Animation standard (more complex) 

For Ready Player Me you have the 

  • Ready Player Me Animation Standard (a lot like PerfectSync) 

For Animaze-native you have the 

  • Native Animaze Standard  (arguably the most complex, but produces the most nuanced results). 

Note: Right now Retargeting Overrides have been enabled only for Live2D avatars.  We’re working on surfacing this functionality for all types of avatars at a later date.

Mapping Premises 

Most of these motion output parameters are on a simple linear intensity scale that goes from 

  • 0% (corresponding to the neutral position)  to 

  • 100% (max intensity).

A sub-set of them are “centered range” type parameters: linear intensity but whose neutral value is in the middle of the range  (50% of the way)  and they can go to max “left” or max “right” as they go to 0% or 100% from the center.

Some of these are tracked by one tracker (like the webcam face tracker or iPhone Arkit), some by a combination of trackers (video plus audio), and some are sourced from various computer peripherals (keyboard, mouse, controller etc).  Some are tracked from more exotic sensors like the Ultraleap (formerly Leap Motion) hand tracker. Some, like ears, are inferred from the behavior of other tracking inputs.

Below we list the names by which you will see them in the drop-down list from the Animaze Editor, in the Retargeting Overrides section. These names may appear a bit cryptic at first sight, but they will make a lot more sense if you keep in mind:

  • L- usually means Left

  • R- usually means Right

  • U- usually means Up

  • D- usually means Down

  • LR: usually means a “centered range” type parameter covering Left to Right. 

  • UD: usually means a “centered range” type parameter covering Up to Down. 

This documentation will evolve base on feedback from you, the creators. A lot of the names in this list we consider self-explanatory but, if they are not, then for sure we will add more explanations.  For any clarification don’t hesitate to reach out to support via email or Discord, 

Available “Retargeting Overrides” Parameter List

Head Rotations  

  • HeadPitch -Head pitch rotation, centered range parameter. 

  • HeadYaw, - Head yaw rotation, centered range parameter. 

  • HeadRoll  -  Head roll rotation, centered range parameter. 

Upper Body Rotations & up/down Stretch (inferred from head 3D position)

  • BodyPitch -Upper Body pitch rotation, centered range parameter. 

  • BodyYaw - Upper Body yaw rotation, centered range parameter.

  • BodyRoll - Upper Body roll rotation, centered range parameter.

  • BodyUpDown - for hunching down or straightening the spine to make the head go higher or lower.

Note that additional whole body translation motions can be generated on the avatar’s body via the Enhanced Body Motions Option in the App’s Overrides Settings.
These bespoke translation options are not available as inputs in Retargeting Overrides (at least for now) 

Mouth

  • MouthSmileUnsure - mouth stretches to the sides, corners go slightly down, like a mouth frown 

  • MouthStretch, - this is in for legacy reasons/prototyping reasons

  • MouthSmileL, - half-smile, left.

  • MouthSmileR - half-smile, right.

  • MouthUnsureL - mouth frown left

  • MouthUnsureR - mouth frown right

  • MouthMoveUp, - mouth moves “up” on the face (typically pushed up by a stiffened lower lip)

  • MouthOpen, - the degree of openness of the inner lip contour. Legacy input, use JawDrop.

  • JawDrop - The degree to which the jaw is moving down from the shut position. 

  • PursedLips, - the amount of pursed/puckered lips 

  • PursedLipsLR, - asymmetric pursed/puckered lips offset to left or right - centered range parameter 

  • MouthUnveiledTeeth, - upper teeth being unveiled by a retracted upper lip 

  • MouthUnveiledTeethDown, - lower teeth being unveiled by a retracted lower lip.

  • MouthUpperLipMBP, - lips pressed together.

  • MouthSmileWithTeethCovered - self explanatory

  • JawLR, - Jaw movement left-right; centered range parameter.

  • JawF, - Jaw being driven forward/ protruding jaw.

  • NoseWrinklerU, -  typically like a “snarl”

  • NoseWrinklerD, - trying to stretch the lower part of the nose down by moving the upper lip as low as it can go. 

Eyebrows

  • BrowIntLeftU  - interior of the left eyebrow, up intensity

  • BrowIntLeftD,  - interior of the left eyebrow, up intensity

  • BrowIntRightU,  - iInterior of the right eyebrow, up intensity

  • BrowIntRightD,  - interior of the right eyebrow,  down intensity

  • BrowExtLeftU, - exterior of the left eyebrow, up intensity

  • BrowExtLeftD,  - exterior of the left eyebrow, down intensity

  • BrowExtRightU,  - exterior of the right eyebrow, up intensity

  • BrowExtRightD,  - exterior of the right eyebrow, up intensity

  • BrowCenterLeftUp  - Middle of the left eyebrow, down intensity. 

  • BrowCenterLeftDow  - Middle of the left eyebrow, down intensity.

  • BrowCenterRightUp - Middle of the right eyebrow, up intensity.

  • BrowCenterRightDown, - Middle of the Right eyebrow, down  intensity

  • BrowSqueezeInLeft, - Left eyebrow squeezing in towards the center of the face.

  • BrowSqueezeInRight,  - Left eyebrow squeezing in towards the center of the face. 

  • BrowStrechOut - legacy parameter (equivalent to symmetrical squeeze)

Eyes and Eyelids

  • EyeLClosed  - the degree to which the left eye is closed 

  • EyeRClosed, - the degree to which the right eye is closed

  • EyeLSize - the degree to which the left eye appears larger due to eyelids being very open (like when the person is surprised or afraid)

  • EyeRSize, - the degree to which the right eye appears larger due to eyelids being very open (like when the person is surprised or afraid)

  • EyeLSquint, - degree of squint on the left eye  (also engaging the lower eyelid)

  • EyeRSquint, - degree of squint on the right eye  (also engaging the lower eyelid)

  • EyeLPupPosX, - left eye pupil/iris position on the X axis (horizontal). Centered range

  • EyeLPupPosY, - left eye pupil/iris position on the Y axis (vertical). Centered range 

  • EyeRPupPosX,- right  eye pupil/iris  position on the X axis (horizontal). Centered range

  • EyeRPupPosY, - right eye pupil/iris position on the Y axis (vertical). Centered range

  • EyePupilDilate, - Eye pupil size

Tongue

  • TongueOut - Degree to which the tongue is sticking out.

  • TongueLR, -  Centered range param.

  • TongueUD, - Centered range param.

Cheeks

  • PuffCheekL 

  • PuffCheekR

Arms 

The arms, hands, and fingers parameters had to be simplified a lot when compared to the raw data coming from the tracker. Note the parameters that move the arms still have the sub-string “hand” in them, but these still do refer largely to arms. The reason they contain the word ”hands” is that the end position of the palm is what is driving most of the arm motion in 3D space via Inverse Kinematics.
Motions (up down left right) here are relative to the shoulder joint.

  • HandR_LR

  • HandR_UD,

  • HandR_CloseFront, - Centered range parameter, back to front.

  • HandR_NaturalPose, - Right arm alongside the body with the elbow bent at 90 degrees  and forearms pointing forward at 0%, and straight arms alongside the body at 100% 

  • HandL_LR,

  • HandL_UD,

  • HandL_CloseFront,  - Centered range parameter, back to front.

  • HandL_NaturalPose,- Right arm alongside the body with the elbow bent at 90 degrees  and forearms pointing forward at 0%, and straight arms alongside the body at 100% 

Hands

Palm of the hand, beyond the wrist. 

Most motions are relative to the wrist. 

  • HandR_SoloLR  - r hand rotating left-right around the wrist. centered range parameter

  • HandR_SoloUD, - r hand rotating up down around the wrist. centered range parameter

  • HandR_SoloTwist, - Rotating the forearm and hand (rotating the wrist)

  • HandL_SoloLR,  - left hand rotating left-right around the wrist. centered range parameter

  • HandL_SoloUD, - left hand rotating up down around the wrist. centered range parameter

  • HandL_SoloTwist - Rotating the forearm and hand (rotating the wrist)

Fingers

This is the degree to which the fingers are curled. Not curled at all means extended.

The count starts from the thumb moving through the finger in order till the pinkie.

  • HandR_Finger1

  • HandR_Finger2,

  • HandR_Finger3,

  • HandR_Finger4,

  • HandR_Finger5,

  • HandL_Finger1,

  • HandL_Finger2,

  • HandL_Finger3,

  • HandL_Finger4,

  • HandL_Finger5,

Visimes

Standard visime shapes, 

  • Viseme_AA 

  • Viseme_AH,

  • Viseme_AO,

  • Viseme_AW,

  • Viseme_OY,

  • Viseme_EH,

  • Viseme_IH,

  • Viseme_EY,

  • Viseme_Y,

  • Viseme_R,

  • Viseme_L,

  • Viseme_W,

  • Viseme_M,

  • Viseme_N,

  • Viseme_CH,

  • Viseme_FV,

Ears

These are not tracked directly.

  • EarLeft_U

  • EarLeft_D,

  • EarRight_U,

  • EarRight_D,

Windows Pointer Device (Mouse and Stylus)

  • MouseAndStylus_X  - horizontal position on screen.

  • MouseAndStylus_Y, - vertical position on screen.

  • MouseAndStylus_LeftClick,

  • MouseAndStylus_RightClick,

  • MouseAndStylus_Scroll,

  • MouseAndStylus_Inclination, - reserved, but not yet implemented

  • MouseAndStylus_Pressure,   - reserved, but not yet implemented.

Keys on the Keyboard

These are values meant to be driven by tracking keyboard activity, to simulate avatar typing.

  • Keyboard_LHand_X  - Left hand position on the surface of the keyboard - horizontal

  • Keyboard_LHand_Y, - Left hand position on the surface of the keyboard - vertical

  • Keyboard_RHand_X, - Right hand position on the surface of the keyboard - horizontal

  • Keyboard_RHand_Y,- Right hand position on the surface of the keyboard - vertical

  • Keyboard_HandR_Finger1, - Finger from “ relaxed”  to “ pushing the key right below”

  • Keyboard_HandR_Finger2, - Finger from “ relaxed”  to “ pushing the key right below”

  • Keyboard_HandR_Finger3, - Finger from “ relaxed”  to “ pushing the key right below”

  • Keyboard_HandR_Finger4, - Finger from “ relaxed”  to “ pushing the key right below”

  • Keyboard_HandR_Finger5, - Finger from “ relaxed”  to “ pushing the key right below”

  • Keyboard_HandL_Finger1, - Finger from “ relaxed”  to “ pushing the key right below”

  • Keyboard_HandL_Finger2, - Finger from “ relaxed”  to “ pushing the key right below”

  • Keyboard_HandL_Finger3, - Finger from “ relaxed”  to “ pushing the key right below”

  • Keyboard_HandL_Finger4, - Finger from “ relaxed”  to “ pushing the key right below”

  • Keyboard_HandL_Finger5, - Finger from “ relaxed”  to “ pushing the key right below”

Gamepad Input

  • Gamepad_Button_A 

  • Gamepad_Button_B,

  • Gamepad_Button_X,

  • Gamepad_Button_Y,

  • Gamepad_Button_BACK,

  • Gamepad_Button_GUIDE,

  • Gamepad_Button_START,

  • Gamepad_Button_LEFTSTICK,

  • Gamepad_Button_RIGHTSTICK,

  • Gamepad_Button_LEFTSHOULDER,

  • Gamepad_Button_RIGHTSHOULDER,

  • Gamepad_Button_DPAD_UP,

  • Gamepad_Button_DPAD_DOWN,

  • Gamepad_Button_DPAD_LEFT,

  • Gamepad_Button_DPAD_RIGHT,

  • Gamepad_Button_MISC1,    /* Xbox Series X share button, PS5 microphone button, Nintendo Switch Pro capture button */

  • Gamepad_Button_PADDLE1,  /* Xbox Elite paddle P1 */

  • Gamepad_Button_PADDLE2,  /* Xbox Elite paddle P3 */

  • Gamepad_Button_PADDLE3,  /* Xbox Elite paddle P2 */

  • Gamepad_Button_PADDLE4,  /* Xbox Elite paddle P4 */

  • Gamepad_Button_TOUCHPAD, /* PS4/PS5 touchpad button */

That’s the whole list for now!

Importing Live2D Format Models

©2020, Animaze, Inc. and the Animaze logo are registered and/or unregistered trademarks of Holotech Studios Inc.