-~CycleAnimation Poseball~- v1.2 by Wolfhaven Productions
The CycleAnimation Poseball is a scripted posing system that will allow you to predefine a series of Animations or Poses that you would like someone to undergo while sitting on or using an object of your creation.
Some uses would be:
* Predefined Modelling Poses
* Predefined Sitting Poses
* Predefined Operational Poses for Roleplay
... and a great many more!
To use the CycleAnimation Poseball you can attach it to whatever you wish (the ball itself is mod) OR you can remove the script and Config notecard and place it in your own prim (advanced builders only please).
Once in place do the following:
1) Place the animations you wish to use in the same prim as the script.
2) Edit the config notecard.
Inside the config notecard you can use several commands:
----------8< Cut Here 8<----------
name::CycleAnim Poseball v1.2
offset::<0,0,0.5>
alpha::Yes
listen::No
button::Sit
anim::Pose1::20
anim::Pose2::15
anim::Pose3::30
anim::Pose5::40
anim::Pose4::20
anim::Pose6::30
----------8< Cut Here 8<----------
Note the command structure is as follows:
command::setting::subsetting (if any)
Note that ALL strings are seperated by a double colon '::'
name:: sets the name that will be displayed in float text over the prim
Example:
name::My Poseball!
Will set the floattext to 'My Poseball!'
name::
Will leave the floattext blank on startup.
offest:: sets how facr above the prim that the avatar will sit from center
The offset is a vector <x,y,z> for the avatars position in releation to the poseball.
Example:
offset::<0,0,0.5>
This would place the avatar 0.5 meters from center above the poseball - note this is based on poseball center AND avatar center (crotch area).
alpha:: sets whether or not the poseball (or prim) should go invisible once someone is sitting on it.
Example:
alpha::yes <----- sets the prim invisible when in use
alpha::true <----- sets the prim invisible when in use
alpha::no <----- sets the prim visible when in use
alpha::false <----- sets the prim visible when in use
listen:: sets whether or not the prim should listen on channel 1 for show/hide commands.
Example:
listen::yes <----- sets the prim to listen when in use
listen::true <----- sets the prim to listen when in use
listen::no <----- sets the prim to not listen when in use
listen::false <----- sets the prim to not listen when in use
When set to Listen the script will respond to /1 show or /1 hide commands typed in chat.
NOTE: Listens CAN induce some small amount of what is referred to as LAG.
button:: sets the text on the right click/pie menu to what you want
Example:
button::SIT HERE!
There ARE a limited number of characters on the pie menu - you can experiment with this to get the affect you find acceptible.
anim::yourpose::seconds sets an animation in the poseball to run for (seconds)
Example:
anim::yourpose::10
would run animation 'yourpose' for 10 seconds then cycle to the next available pose.
anim::yourpose1::10
anim::yourpose2::8
anim::yourpose2::15
would run animation yourpose1 for 10 seconds, yourpose2 for 8 seconds and yourpose3 for 15 seconds, then repeat the loop.
You can potentially have as many as 300 poses in a single poseball that cycle continuously.
Designer API:
The script also has an API function - it will listen for linked messages on channel 99. if it hears 'show' it will go visible and if it hears 'hide' it will go invisible.
Touch Function
The script will respond to touches by setting itself visible or invisible on touch - IF alpha is enabled. Otherwise it simply hides the float text name.
When the script first starts up it will cycle through the load functions to read the notecard. It will do this on rez or whenever you make a change to the contents of the inventory of the prim the script is in.
It will read off the names of the poses loaded in floattext followed by a number - the number represents how much memory the script has remaining for information storage after load. If this number reaches ZERO the script will cease to function until reset.
Once ready it will display the name of the pose series in hovertext (if there is one) and you're ready to pose!
If you have any questions or comments about the CycleAnimation Poseball v1.2 from Wolfhaven Productions, please send an Email to support@wolfhavenproductions. IM's and notecards passed via profile tend to get lost. Email will be answered as quickly as possible, and you may be contacted by a Wolfhaven Representative in-world.
Thank you again for your interest in this product!
~Traven Sachs
http://slurl.com/secondlife/Silla/190/32/94
