Project Bento Skeleton Guide
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.
| 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:
| 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
| 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
| mTail1 | For animating a tail |
| mTail2 | |
| mTail3 | |
| mTail4 | |
| mTail5 | |
| mTail6 |
Other
| mGroin | For animating any groin-related appendages |
New Attachment Points
| Location | Number | Description |
|---|---|---|
| Left Ring Finger | Linked to the mHandRing1Left and mHandRing1Right joints, suitable for rings and such. | |
| Right Ring Finger | ||
| Tail Base | Linked to the first tail joint, mTail1. | |
| Tail Tip | Linked to the last tail joint, mTail6 | |
| Left Wing | Linked to the wing joints mWing4Left and mWing4Right | |
| Right Wing | ||
| Jaw | Linked to the mFaceJaw joint. | |
| Alt Left Ear | 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 | ||
| Alt Left Eye | Linked to the new Alt eye joints mFaceEyeAltLeft and mFaceEyeAltRight. | |
| Alt Right Eye | ||
| Tongue | Linked to mFaceTongueTip | |
| Groin | 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.