Simple Single Sitter

To follow this small tutorial you need nPose V4.00.
If you got nPose v4.00 inworld, you have to unpack it (Rezz the objects that have "~ boxed" in their names and click them).

This document assumes that you have a basic understanding of editing and adjusting objects in world. This document also assumes that you have unpacked nPose Release and can be found in your inventory. If not, the latest release can be found either on marketplace for free or at nPose HQ.

To make the most simple object animate an Avatar when seated, rez this object in world and add the following items from nPose release to the contents, found in the nPose Release 4.00 distribution:

• object: Adjuster
• script: nPose Core
• script: nPose Dialog
• script: nPose Menu
• script: nPose NC Reader
• script: nPose Slave
• notecard: .init
• notecard: SET:DEFAULTCARD
• notecard: SET:Utilities:Admin:Adjust
• notecard: SET:Utilities:Admin:PosDump
• notecard: SET:Utilities:Admin:StopAdjust
• notecard: SET:Utilities:Admin{owner}

Setting up the number of sitters allowed

Once this is done the object will function with a menu. Click the object and a dialog menu will pop up on your viewer screen. We cannot sit our object however. We will need to add a couple more things to allow us to sit.

In this object with all the items above, edit the .init notecard and add the following line that will tell nPose how many sitters is to support: SEAT_INIT|1

Adding the information nPose needs to animate and position a sitter

Pick a single animation from your inventory to be used to animate a sitter and add it to the contents of the object. For the purpose of this document, I will use the animation named "meditation". If you don't have this animation, any that you have in your inventory will work.

One more item is needed to complete the nPose object and allow an Avatar to sit and use "meditate". Open the SET:DEFAULTCARD notecard and add a line to tell nPose which animation and where to position our Avatar. See [NC-Names](#nc names) for more about notecard names:

XANIM|1|meditation|<0.0, 0.0, 0.0>|<0.0, 0.0, 0.0>

• XANIM is the key word nPose uses to say 'this line contains information about an animation.
• The vertical bar '|' is a separator that nPose recognizes so it can tell when current data ends and new data begins.
• The number '1' tells nPose which seat the information in this line will be associated with.
• meditation is the name of the animation file in contents that this line will be using to animate a sitter.
• This first vector is the position vector used to position the sitter relative to the nPose enabled object. This line is simply giving nPose something to get us started. nPose will give us better numbers in a moment.
• This second vector is the rotation vector used for setting the rotation information used by the nPose object.

Save this notecard and reset the scripts so that nPose scripts will read the .init notecard and load the SET:DEFAULTCARD. See more about notecard names Here.

Now this object will be functional and any single Avatar can sit this object.

To discover what nPose is now capable of, click for menu and see a button named "DEFAULTCARD" derived from the notecard name we just added the line above in. We also see the "Utilities" button derived from the notecards we originally added to the object contents.

Adjusting The position and rotation of the animation

Stand from the object and follow the instructions below:

It is possible that the position of our Avatar is correct but not likely. The following notes will tell you how to adjust the position and rotation of the seated Avatar:

• Click the nPose object for menu.
• Select "Utilities" from the menu which appears on your viewer screen.
• Select "Admin" from the menu which appears next on your viewer screen.
• Select "Adjust" from the menu which appears next on your viewer screen.

An Adjuster will be rezzed right where you should be if seated. If your animation file has copy permissions the adjuster will have a female animesh character attached. Change the gender of the animesh by clicking the adjuster if needed. Edit and move this adjuster to the position which best suits your needs. The new position and information will be sent to your local chat which will look like the line we added to the SET:DEFAULTCARD notecard. Each time the Adjuster is moved, a new line of information will be sent to local.

When the seated Avatar is in a position that suits your needs, copy the last line from local and replace the line in the SET:DEFAULTCARD notecard for permanent adjustments to be used.

This completes the nPose setup for a single sitter who is animated with "meditation" animation.

To expand this nPose object and add more pose sets, add another animation to the nPose object and create another SET type notecard to drive this animation and follow the same instructions to add the contents as described above. Add this notecard to the same nPose object and you will see another button when clicking for menu to select this pose.