Project Bento Skeleton Guide

From Second Life Wiki
Revision as of 16:53, 18 December 2015 by ObviousAltIsObvious Resident (talk | contribs) (→‎New Attachment Points: id numbers from avatar_lad.xml)
Jump to navigation Jump to search

The following is a brief summary of the updates to the skeleton for the Bento project.

New Bones

There are 80 new bones added for Bento. The largest number are for support of facial expressions and finger movement. Any time joints are numbered, they go from lowest number closest to the body center, to highest number farthest from the body center.

Hands

There are 30 finger joints, 15 on each hand - 3 joints per finger times 5 fingers. They are named as follows: mHand<finger><number><side> , where fingers are Thumb, Middle, Index, Ring, and Pinky, number is 1,2 or 3, and side is Left or Right.

List of hand bones
mHandThumb1Left mHandThumb1Right
mHandThumb2Left mHandThumb2Right
mHandThumb3Left mHandThumb3Right
mHandIndex1Left mHandIndex1Right
mHandIndex2Left mHandIndex2Right
mHandIndex3Left mHandIndex3Right
mHandMiddle1Left mHandMiddle1Right
mHandMiddle2Left mHandMiddle2Right
mHandMiddle3Left mHandMiddle3Right
mHandRing1Left mHandRing1Right
mHandRing2Left mHandRing2Right
mHandRing3Left mHandRing3Right
mHandPinky1Left mHandPinky1Right
mHandPinky2Left mHandPinky2Right
mHandPinky3Left mHandPinky3Right

Face

There are a total of 32 new joints on the head and face:

List of face bones
mFaceForeheadLeft For animating the forehead
mFaceForeheadRight
mFaceEyebrowOuterLeft For animating the eyebrows
mFaceEyebrowCenterLeft
mFaceEyebrowInnerLeft
mFaceEyebrowOuterRight
mFaceEyebrowCenterRight
mFaceEyebrowInnerRight
mFaceEyeLidUpperLeft For controlling the upper and lower eyelids
mFaceEyeLidLowerLeft
mFaceEyeLidUpperRight
mFaceEyeLidLowerRight
mFaceEyeAltLeft By default, these are in the same location as the default mEyeLeft and mEyeRight bones. They could be used to control additional eyes, or to control eye orientation via animations. The default eye bones are not suitable for use in animations because they are controlled directly by the Second Life viewer.
mFaceEyeAltRight
mFaceEarLeft These allow ears, antennas, or any other head appendages of your choice to be animated.
mFaceEarRight
mFaceNoseLeft For animations involving the nose
mFaceNoseCenter
mFaceNoseRight
mFaceCheekUpperInnerLeft For animations involving the cheeks
mFaceCheekUpperOuterLeft
mFaceCheekUpperInnerRight
mFaceCheekUpperOuterRight
mFaceJaw For opening and closing the mouth. Note that the tongue and lower lip bones are parented to the jaw.
mFaceLipUpperLeft For controlling the upper lips and mouth corners
mFaceLipUpperRight
mFaceLipCornerLeft
mFaceLipCornerRight
mFaceTongueBase For animating the tongue
mFaceTongueTip
mFaceLipLowerLeft For animating the lower lip
mFaceLipLowerRight

Wings

List of wing bones
mWing1Left For controlling the wings
mWing2Left
mWing3Left
mWing4Left
mWing1Right
mWing2Right
mWing3Right
mWing4Right
mWingsRoot1 These joints lie at the base of the wings, and are intended to make it easier to move and potentially repurpose the wings. For example, defining position offsets for these joints could allow the "wings" to be moved to the front of the avatar and used as an additional set of arms or legs. Potentially they could also be used as a hinge mechanism to allow use of the "wings" as objects that are not physically connected to the avatar, such as pets.
mWingsRoot2
mWingsRoot3

Tail

List of tail bones
mTail1 For animating a tail
mTail2
mTail3
mTail4
mTail5
mTail6

Other

List of other joints
mGroin For animating any groin-related appendages


New Attachment Points

List of new attachment points
Location Number Description
Left Ring Finger 41 Linked to the mHandRing1Left and mHandRing1Right joints, suitable for rings and such.
Right Ring Finger 42
Tail Base 43 Linked to the first tail joint, mTail1.
Tail Tip 44 Linked to the last tail joint, mTail6
Left Wing 45 Linked to the wing joints mWing4Left and mWing4Right
Right Wing 46
Jaw 47 Linked to the mFaceJaw joint.
Alt Left Ear 48 Linked to the new mFaceEarLeft and mFaceEarRight joints. Called "Alt" ears because there are already ear attachment points connected to the head.
Alt Right Ear 49
Alt Left Eye 50 Linked to the new Alt eye joints mFaceEyeAltLeft and mFaceEyeAltRight.
Alt Right Eye 51
Tongue 52 Linked to mFaceTongueTip
Groin 53 Linked to mGroin

Slider Support

We have limited support for the shape controls found under "Edit Shape". Currently avatar height, avatar width, head size, and the male/female gender switch are believed to work. We will be adding some additional slider support during the Project Viewer test period, but it is unlikely that all the existing sliders will be supported; many of them are based on a blend shape mechanism that is not available with uploaded meshes.