User:Rev Eponym/nPose

nPose new documentation

Warning: If you're reading this, it is unofficial. Testing and composition only!

nPose is a system for coordinating animations between several avatars seated on the same object (linkset), such as a couch or bed, as well as rezzable, coordinated props. Unlike previous systems, nPose does not use poseballs to accomplish this.

What's a 'posing system'?

Null

nPose Notecard Types

nPose uses different types of notecards to define its customized menu functions. Each of these notecards has its type spelled out in capitals at the beginning of its name, like so:

Notecard Type	Function	..	Example name
DEFAULT	Animations	..	DEFAULT:Sitting
SET	Animations	..	SET:Lounging
BTN	Script messaging	..	BTN:Colors
SEQ	Sequences of Sets	..	SEQ:Line Dance

Important: The type name must be in all caps, with no spaces, with a colon(':') before the rest of the name. Without this, the scripts won't be able to find the notecards, and the item will not appear in the menu.

DEFAULT - Used as the default pose set when nPose is initialized, and there can be only one with this type. Otherwise, it's the same as SET below. If no DEFAULT notecard is included in the contents of the nPose object, nPose will use the first SET notecard in the contents (alphabetically) as the DEFAULT.

SET - Used to define a group of animations which will appear in the nPose menu with the name after the colon in the notecard name. The notecard contains one line for each sitter, listing animation name and position. There can also be other lines, for functions that will be triggered along with the animation set. The -keywords- section defines the different function types available.

ANIM|meditation|<-0.3,0,0.8>|<0,0,0>

where ANIM says that this line describes an animation, and "mediation" is the name of the animation (which must be included in the nPose object), and the rest is a position offset and rotation. There is one ANIM line for each avatar who can sit on the nPose object. You can put <0,0,0> for both position and rotation, and use the nPose adjustment tool to find the proper values. We'll describe how later. You can also include LINKMSG and other types of lines in the SET notecards, and those will be described later also.

BTN - This notecard type is used to send messages to other scripts immediately and typically used to communicate with other scripts (mostly plugin scripts) in the nPose build or props. This is a powerful notecard type and can be used for a wide variety of things.

The most common thing to put in BTN notecard is LINKMSG lines. These have the general format (again without leading spaces):

LINKMSG|msg-number|user-string|some-key

where msg-number is some number set by convention (see the LINKMSG messages notecard) and the remaining (optional) fields are defined by the message number.

SEQ - This notecard type is used to setup sequences of pose sets. It communicates to the modified Rygel sequencer script. Details are provided later.

<lsl> default {

   state_entry()
   {
       llSay(0, "Hello, Avatar!");
   }

   touch_start(integer total_number)
   {
       llSay(0, "Touched.");
   }

} </lsl>