Difference between revisions of "MLPV2 Users Tutorial"

From Second Life Wiki
Jump to navigation Jump to search
(Original MLP User Help Version 3.7. Chaz Longstaff. Originally published December 2006. Updated April 2011.)
 
 
(5 intermediate revisions by 2 users not shown)
Line 1: Line 1:
* MLP User Help Version 3.7. Chaz Longstaff. Originally published December 2006. Updated April 2011.
{{multi-lang}}
{{Navbox/MLPV2}}


An MLP Product is one with a set of scripted animations in it. This combined core set of scripts and animations may sometimes be referred to as an "engine."
== Introduction ==


It is commonly used in furniture, cushions, rugs, etc, for a variety of purposes and themes.
MLPV2 is a system that provides a menu to select poses, used in furniture.  It can be built into a product, or it can be a self-contained "engine" that can be added to other objects.


MLP Products rez "pose balls" for the users of it to sit on, after which the animations act upon the people sitting on the poseballs.
To use it, you click on the object, which presents a blue menu popup, allowing you to choose poses to enjoy, or to control MLPV2 features.  If you select a pose, it rezzes "poseballs", which you sit on.


The animations may be selected one by one via a menu (that you click the product to access), or the animations may progress sequentially by scene.
== First Use ==


MLP is a solid product with a long history in Second Life. It was first invented in 2006 by Miffy Fluffy, and has been updated since 2008 for the benefit of the Second Life community by Lear Kale. Your personal support for your MLP Product is provided directly by the person you purchased the product from.
The first time you use your MLPV2 product, it may need to initialize itself.  Click it.  If you get a menu; fine: it's ready to go. Otherwise, it will spend some time pulling itself together; just wait until it says it's ready.  Sometimes you may need to click it twice to get it started. (Sorry; this is an SL bug.)


This help is intended for purchasers of MLP Products. It walks you first through bringing the product home and getting it started, then covers some more advanced topics that some users ask about from time to time.
== Normal Use ==
* Click it to get the menu
* Select a pose.  Poseballs will appear.
* Sometimes poseballs will be hidden; if you don't see the number of poseballs you expect, try a different pose.
* To use a poseball, right-click it and select "sit" from the pie menu
* A prompt will appear on the screen asking for permission to animate you; click "Yes" to accept
* To change positions, just use the menu to select a different pose.
* When you're done, you can do any of the following:
** use the SL viewer's "Stand" button, but sometimes this may cause you to jump a bit
** If the MLPV2 menu has a STAND button, you can use that to avoid this
** use the MLPV2 menu's STOP button, which will unseat everyone sitting on one of the product's poseballs


We hope you will enjoy using your MLP Product as much as we have enjoyed creating it for you! Cheers!
Use the STOP button to make the poseballs go away and put the product into "standby" mode where it causes less lag but is always ready to use.


Use "OPTIONS -> Shutdown... -> Shutdown!" to completely turn it off, minimizing lag.  Before it can be used again, you'll have to start it back up as described in "First Use" above, and ordinarily, only the owner can do this.


= FIRST TIME USE =
=== A note about the poseballs ===
 
* Place the MLP Product where you want it;
* Left-click the MLP Product to activate it;
* The very first time you use it, it will take about a minute to load all the data it needs to know;
* When everything has loaded (the green chat messages stop appearing on the screen), it is ready to use;
* You'll never have to go through these steps again;
* Now left-click the mat again for the menu;
* Select a pose;
* The appropriate poseball or poseballs will be generated automatically;
* Some types of bed, chairs, sofas, etc. may have high, dense cushions that cause the poseball to be hidden out of sight – should that happen, pick another pose that lets you see a poseball, sit on it, and then use the menu to choose the pose you actually want;
* To use a poseball, right-click on it and select SIT from the pie menu;
* A prompt will appear on the screen asking for permission to animate you;
* You need to say "Yes";
* To change positions, left-click on a spot of the MLP Product that you can see to bring the menu up again and choose the new position;
* You will be moved automatically to the new position, without further permission prompts and without having to stand up, etc;
* When you have finished, you can stand up by clicking the "stand" button that will appear at the bottom of your screen;
* The poseball(s) will automatically hide themselves again when you either click the "stop" button on the menu, or the "off" button (under the "Shutdown" submenu). The Stop button basically just hides the poseball; the "off" button actually turns it off, and will reduce the script count on your parcel should you ever need to do that;
* Note: there is no need to use the stop or off if you don't mind the poseball(s) showing.
 
 
= A NOTE ABOUT THE POSEBALLS =


There is no need for a hide or show command, as there is with individual sets of pose balls: these poseballs show themselves when needed, and hide themselves when not!
There is no need for a hide or show command, as there is with individual sets of pose balls: these poseballs show themselves when needed, and hide themselves when not!


Unlike other poseball(s), these aren't "real"; they are just "virtually generated" copies of the ones inside the MLP Product. If you right-click over a poseball and delete it, a fresh poseball to take its place would be regenerated the next time you activated or restarted the MLP Product.
Poseballs are created by the MLPV2 system whenever they're needed. If you delete one, you can use the STOP menu button and then select a pose and it will reappear. They're not precious, so don't worry about them. Also, note that the creator of the poseball is *not* the creator of the furniture or the poses.
 
This also means, though, that you can't adjust sit positions by adjusting the poseballs, as you do other poseballs. Any positioning you did in this fashion -- by using edit arrows to heave them about -- would be lost the next time the mat was shut down and restarted. Instead, the positioning they use comes from inside the MLP Product. See the "Adjusting Positions" section for information on how to adjust positions.
 
As well, should an MLP Product be taken away while poseball(s) are generated above it, the poseball(s) left behind will auto destruct in a matter of minutes if its MLP Product is more than 10 metres away (again the MLP Product will just generate new ones in its new location.) If some sim weirdness happens and they don't self-destruct, just delete 'em.
 


= ADJUSTING POSITIONS =
If a pose needs adjustment to fit your avatar, see "Adjusting Positions" below.  If you simply move the poseball, it will revert to its original position when you choose the pose again.


* Activate the menu and choose a position as described above; leave the menu running.
If you remove the MLPV2 product while poseballs are visible, they will automatically disappear in a few minutes, or you can delete them yourself.
* Sit on a poseball.
* Look for the Advanced button; click on it to arrive at the Advanced sub-menu;
* In the Advanced sub-menu, look for and click on the button that says "Adjust Pos".
* You'll see that the poseball(s) get transformed into semi-transparent beams -- these are what you adjust.
* Right-click the beam for the poseball you are on. From the pie menu that appears, left-click the Edit choice.
* Use the up, down and sideways arrows to adjust the position, as well as the rotate option (if you haven't yet worked with any of these items, you may wish to first create a disposable prim of any shape somewhere else and try moving it about to gain the dexterity first.)
* To see how the pose is coming along from all angles, use the right and left arrows on your keyboard to swivel around, and the up and down arrows to zoom in and out
* Tip! When doing this, you may wish to place the pose mat on a chair or sofa in a relatively unobstructed area, so that you don't swivel around just to find your view blocked by a wall, etc.
* While doing all this, leave it at the menu where you found the "Adjust Pose" button
* When you are happy, click the "Save Pose" button. You may even wish to click it as you go along to consolidate your gains, as it were. This saves information about the pose into the memory of the MLP Product (not into the .positions notecard -- more on that later).
* Should you wish for some reason, you can adjust the pose to be up to a maximum of 10 metres away from the MLP Product (this 10 metres maximum is an SL system limitation)
* When it's saved, if you wish to move onto another pose to adjust that pose, click the back menu to get back to sitting choices, choose a sit pose and start the process all over again
* To get rid of the adjusting beam, click the "Adjust Pose" button on the menu again to toggle it off.
* While you have the adjust beams out, whenever you move to another pose, the adjustments you made to the previous one will be automaticaly saved. However, on the very last pose you adjust, if you don't go to another pose, they won't be -- so even though you may need need to go to another pose to adjust it, just do so anyway -- go to any other pose, to make sure the last one you did gets saved.


== Height Adjustment ==


= Z (ON THE FLY) ADJUSTMENTS =
Sometimes all the poses are too high or too low for the furniture item.  To fix this, use the "OPTIONS -> HEIGHT" menu.  Choose any pose and adjust the height up or down (by the given number of centimeters) until the poses look good.  '''This affects all poses equally.'''


The height adjustment is stored in the object's Description field.  If you clear this or change it to something that's not a number, the height offset will revert to zero.


* Now it's going to be impossible to get some poses exactly right for everybody. For instance, a very short person may find him or herself sitting on a sofa with his/her legs dangling off of it; a very tall person may find her/himself sitting with her/his feet embedded into the floor. For on the spot adjustments, "sitters" can use the Z adjustments on the Height menu (under Options.)
== Adjusting Positions ==
* Note though that Z adjustments apply to all the poses not just the one currently being used
* The increments are in centimetres. By default, they are set to do plus and minus 1 cm; or, plus and minus 10 cm. If you want to edit the increments offered through the user menu, you need to change those increments in the menu notecard.
* To reset it after a particular guest has made him or herself comfy using the Z positions, just edit the MLP Product and look in the description line - that's where the adjustment is stored. Just clear it out of there.


* Choose a position as described above
* Sit on a poseball, along with any other participants.
* In the menu, select "OPTIONS -> Adjust Pos"
* You'll see that all poseballs get transformed into semi-transparent beams -- these are what you adjust.
* Right-click the beam for a poseball you want to adjust. From the pie menu that appears, left-click the Edit choice.  Colored arrows will appear at the center of the poseball.
** Drag the colored arrows to adjust the position
** Hold the Control (Apple) button and drag the colored circles to adjust the rotation
* If you goofed up and want to abandon changes to a pose, you can select it again, or stop adjusting by selecting "Adjust Pos" again.
* When you're satisfied, you can use "Save Pos" to save the position, or you can choose another pose (which will automatically save the position).
* When you're done adjusting poses:
** Be sure to save the current pose (if you've changed it and want to save it) using "OPTIONS -> Save Pos".
** Use STOP if you want to quit, or
** Use "OPTIONS -> Adjust Pos" to stop adjusting but remain in the pose.


= BACKING UP POSITIONS =
IMPORTANT NOTE: MLPV2 will remember your adjustments, but will forget them if it gets shutdown or if you reset the scripts.  See "Save positions to notecards" below to avoid this.


Getting positions just right can be a lot of work. And what a nuisance to lose them and have to do them all over again owing to some SL weirdness! That's where the .POSITIONS notecard comes in -- you can backup in them the memory of the positioning you saved.
== Saving Positions to Notecard ==
* To do this, go into the Options menu, and click the "Memory Dump" button.
* The memory of the positions will be "chatted (i.e. printed) out to your screen"
* You will get lines that look like this:
[23:11]  {default} <-1.964,0.054,0.293> <124.4,79.8,67.0> <0.700,0.000,0.700> <0.0,0.0,-180.0>
* Go into chat history (the history button at the bottom of your screen, highlight all the position info, and go Control-C to copy it (Apple-C on a Mac).
* Right-click over the MLP Product, choose edit, click on the MORE button if the bottom of the edit info box isn't showing, then click on the Objects tab. Location the .POSITIONS notecard. Right-click over it and choose open.
* Delete out everything that is in there, and paste in what you just copied. Don't leave any blank lines. Save and close the notecard. You now have a safe backup of all your positions.
* Note: when can positions be lost out of memory? Positions stay in memory even after the MLP Product is shut down, restarted, taken back into inventory or moved about and placed somewhere else. They only get lost if the memory gets too full (by adding other positions or menu items) causing it to crash, or if the memory gets reset back to blank by resetting scripts.
* Note: so if the memory gets blanked out, how does the .POSITIONS notecard help? If the memory is blank, the MLP Product will read positions instead from the .POSITIONS notecard.


* Use "OPTIONS -> DumpPos".  The product will chat all of its positions.
* Copy the text between (but not including) the "----------------------" lines.
* Paste these lines into a notecard called .POSITIONS


= PROPS =
* Right-click the MLP Product, choose edit.  In the edit popup, select the "Contents" tab.
* Find the notecards whose names begin with ".POSITIONS".  (There may be one or more.)
* If you like to be careful, drag these into your inventory as a backup.  Then, in the object's contents, delete all but one (usually, .POSITIONS).
* Paste what you copied above into this notecard, replacing its contents completely.
* Save the notecard.


The .POSITION notecard is re-read whenever the product is reset or restarted.  This can be necessary after a "stack-heap error".  For more information, see the [[ MLPV2 User's Reference]].


Some of the animations will rez cushions, ETC, to go with them. If there is an animation that you'd rather this didn't happen with, note the name of the animation. Edit the .Props card inside the MLP Product, delete the line for that animation, save your work, and restart the MLP Product using the restart option under the shutdown submenu.
== Props ==


Some of the animations will rez prop objects, such as cusions. If there is an pose that you'd rather this didn't happen with, note the name of the pose.  Edit the .PROPS card inside the MLP product, delete the line for that pose, save your work, and restart the MLP Product using "OPTIONS -> Shutdown -> Pos Reset".  ("OPTIONS -> Shutdown... -> Restart" will work too, but it will reset the menu too and take longer.)


You can adjust the position of props to suit your avatar or furniture, using a method similar to "Adjusting Positions" above.  Use "OPTIONS -> Adjust Props"; adjust the prop, and either choose a new pose (which saves automatically) or save using "OPTIONS -> Save Props".  Save to notecards using a method like "Saving Positions to Notecards", but use "OPTIONS -> Dump Props" and notecards begging with ".POSITIONS".


= ACCESS CONTROL =
== ACCESS CONTROL ==


* The Owner of the MLP Product is the only person who can: initially start, shutdown and restart the MLP Product. This is a limitation of the MLP script used as the engine, and can't be changed.
The Owner of the MLP Product is the only person who can do the following:
* To make it easier for your guests to fire it up as needed, instead of shutting it down after use, just use the Stop button. Then all your guests have to do to use it is left-click it to cause the usermenu and the poseball(s) to re-appear.
* initial startup
* If you wish to restrict choices to various menus and actions, edit the .MENUITEMS notecard (using the same procedure as for the .POSITIONS notecard to find it and open it up.
* shutdown
* Wherever you see | ALL beside a menu option that is where you can change permissions by swapping out the ALL keyword and replacing it with another. Valid keywords are: ALL, GROUP and OWNER.
This is a limitation of the MLP script used as the engine, and can't be changed.
* By default, many of the settings-type submenus come restricted to group. This stops any old tom, dick or harry wandering by from monkeying with them. Group members just need to have the group tag activated to access these sub-menus. If you have a large public group, you may wish to restrict this further by changing it from Group to Owner.


To allow guests to use it when you're not available, use "STOP" rather than "Shutdown!"


= HELP! =
By default for most products, all users are allowed to use poses, but only the owner is allowed access to the OPTIONS menu and to adjust poses or turn posename chatting on and off.  However, you can restrict access to the pose menus to owner-only or group-only, by editing the notecards that begin with .MENUITEMS (there will be one or more of these).


* Wherever you see ALL next to a menu name, you can change this to GROUP or OWNER.


Q: Something weird is happening with the poses. I'm using them, but it looks like I'm up in the air. Or, the transition between poses has gone all jerky and slo-mo.
Landlords may wish to set the OPTIONS menu to allow GROUP access (rather than OWNER), so that renters can adjust poses. They will not be able to save them to notecards, and a reset will restore the original positions, for subsequent renters.
A: Yep. We've seen it. It's happened to us, both with the MLP Products and with many other many-driven pose things in SL. It can be a real pain, especially when it's a bed-pose menu and you're, um, right in the heat of things! Essentially, it's caused by SL weirdness at that moment. Sometimes only you see the weirdness, sometimes others see it instead of you, sometimes you both see it. It's a temporary display thing on the screen, and nothing is wrong with the MLP Product or your eyesight. The visual display will fix itself on the screen of the person seeing the weirdness the next time they log into SL. To fix the visuals right away, the person seeing the weirdness needs to log out of SL and back in. That almost always fixes it on the spot. The 1% of the time it doesn't, the display will resolve itself the next day. Granted, logging out can kill a special moment like nothing, so sometimes we just "pretend" that everything looks as it should.


Also, sometimes the first pose you fire up can be off, even though you left it just fine the night before. Switch momentarily to another pose, then back to the pose you want.
See also: ## What about group-owned land ##


And *above all*, see if an AO (Animation Overrider) is turned on. Some poses and animations in SL will work with someone's AO turned on, but many will not.


== HELP! ==


Q: In my inventory, my MLP Product says "no modify." So how can I edit the notecards, etc?
Q: In my inventory, my MLP Product says "no modify." So how can I edit the notecards, etc?
Line 123: Line 108:
A: Yep. We've seen that from time to time. Just click "Yes" to continue.
A: Yep. We've seen that from time to time. Just click "Yes" to continue.


Q: The scripts in the MLP Product won't run for me.
[[Category:MLPV2]]
A: Yep, we've seen that one, too.  Check to see if the following is true: you are on rented land or in a rented house, and if there is an icon at the top of the screen showing that scripts are disabled where you are.  Normally, when land owners disable scripts, they still leave them enabled for group members - and normally, renters are invited to be group members. So, do the following (a) if scripts are enabled only for group members and (b) you are a member of such a group: Stop the MLP Product using the menu. Pick the MLP Product back up and take it back into your inventory. Set your active group to the group in question (Edit - Groups - highlight the land group, and press the Activate button.) Set the MLP Product back out. It will now be set to group. (Or, edit the MLP Product, and on the first tab, use the group button to set it to the group in question.)
 
Q: How do I turn off the chat info and the whispering? I don't want these informational messages.
 
Click on the MLP Product to bring up menu. Click options. Then click the Chattiness button. This toggles those messages off and on.
 
 
* MLP User Help Version 3.7. Chaz Longstaff. Originally published December 2006. Updated April 2011.

Latest revision as of 09:15, 25 December 2011


Introduction

MLPV2 is a system that provides a menu to select poses, used in furniture. It can be built into a product, or it can be a self-contained "engine" that can be added to other objects.

To use it, you click on the object, which presents a blue menu popup, allowing you to choose poses to enjoy, or to control MLPV2 features. If you select a pose, it rezzes "poseballs", which you sit on.

First Use

The first time you use your MLPV2 product, it may need to initialize itself. Click it. If you get a menu; fine: it's ready to go. Otherwise, it will spend some time pulling itself together; just wait until it says it's ready. Sometimes you may need to click it twice to get it started. (Sorry; this is an SL bug.)

Normal Use

  • Click it to get the menu
  • Select a pose. Poseballs will appear.
  • Sometimes poseballs will be hidden; if you don't see the number of poseballs you expect, try a different pose.
  • To use a poseball, right-click it and select "sit" from the pie menu
  • A prompt will appear on the screen asking for permission to animate you; click "Yes" to accept
  • To change positions, just use the menu to select a different pose.
  • When you're done, you can do any of the following:
    • use the SL viewer's "Stand" button, but sometimes this may cause you to jump a bit
    • If the MLPV2 menu has a STAND button, you can use that to avoid this
    • use the MLPV2 menu's STOP button, which will unseat everyone sitting on one of the product's poseballs

Use the STOP button to make the poseballs go away and put the product into "standby" mode where it causes less lag but is always ready to use.

Use "OPTIONS -> Shutdown... -> Shutdown!" to completely turn it off, minimizing lag. Before it can be used again, you'll have to start it back up as described in "First Use" above, and ordinarily, only the owner can do this.

A note about the poseballs

There is no need for a hide or show command, as there is with individual sets of pose balls: these poseballs show themselves when needed, and hide themselves when not!

Poseballs are created by the MLPV2 system whenever they're needed. If you delete one, you can use the STOP menu button and then select a pose and it will reappear. They're not precious, so don't worry about them. Also, note that the creator of the poseball is *not* the creator of the furniture or the poses.

If a pose needs adjustment to fit your avatar, see "Adjusting Positions" below. If you simply move the poseball, it will revert to its original position when you choose the pose again.

If you remove the MLPV2 product while poseballs are visible, they will automatically disappear in a few minutes, or you can delete them yourself.

Height Adjustment

Sometimes all the poses are too high or too low for the furniture item. To fix this, use the "OPTIONS -> HEIGHT" menu. Choose any pose and adjust the height up or down (by the given number of centimeters) until the poses look good. This affects all poses equally.

The height adjustment is stored in the object's Description field. If you clear this or change it to something that's not a number, the height offset will revert to zero.

Adjusting Positions

  • Choose a position as described above
  • Sit on a poseball, along with any other participants.
  • In the menu, select "OPTIONS -> Adjust Pos"
  • You'll see that all poseballs get transformed into semi-transparent beams -- these are what you adjust.
  • Right-click the beam for a poseball you want to adjust. From the pie menu that appears, left-click the Edit choice. Colored arrows will appear at the center of the poseball.
    • Drag the colored arrows to adjust the position
    • Hold the Control (Apple) button and drag the colored circles to adjust the rotation
  • If you goofed up and want to abandon changes to a pose, you can select it again, or stop adjusting by selecting "Adjust Pos" again.
  • When you're satisfied, you can use "Save Pos" to save the position, or you can choose another pose (which will automatically save the position).
  • When you're done adjusting poses:
    • Be sure to save the current pose (if you've changed it and want to save it) using "OPTIONS -> Save Pos".
    • Use STOP if you want to quit, or
    • Use "OPTIONS -> Adjust Pos" to stop adjusting but remain in the pose.
IMPORTANT NOTE: MLPV2 will remember your adjustments, but will forget them if it gets shutdown or if you reset the scripts.  See "Save positions to notecards" below to avoid this.

Saving Positions to Notecard

  • Use "OPTIONS -> DumpPos". The product will chat all of its positions.
  • Copy the text between (but not including) the "----------------------" lines.
  • Paste these lines into a notecard called .POSITIONS
  • Right-click the MLP Product, choose edit. In the edit popup, select the "Contents" tab.
  • Find the notecards whose names begin with ".POSITIONS". (There may be one or more.)
  • If you like to be careful, drag these into your inventory as a backup. Then, in the object's contents, delete all but one (usually, .POSITIONS).
  • Paste what you copied above into this notecard, replacing its contents completely.
  • Save the notecard.

The .POSITION notecard is re-read whenever the product is reset or restarted. This can be necessary after a "stack-heap error". For more information, see the MLPV2 User's Reference.

Props

Some of the animations will rez prop objects, such as cusions. If there is an pose that you'd rather this didn't happen with, note the name of the pose. Edit the .PROPS card inside the MLP product, delete the line for that pose, save your work, and restart the MLP Product using "OPTIONS -> Shutdown -> Pos Reset". ("OPTIONS -> Shutdown... -> Restart" will work too, but it will reset the menu too and take longer.)

You can adjust the position of props to suit your avatar or furniture, using a method similar to "Adjusting Positions" above. Use "OPTIONS -> Adjust Props"; adjust the prop, and either choose a new pose (which saves automatically) or save using "OPTIONS -> Save Props". Save to notecards using a method like "Saving Positions to Notecards", but use "OPTIONS -> Dump Props" and notecards begging with ".POSITIONS".

ACCESS CONTROL

The Owner of the MLP Product is the only person who can do the following:

  • initial startup
  • shutdown

This is a limitation of the MLP script used as the engine, and can't be changed.

To allow guests to use it when you're not available, use "STOP" rather than "Shutdown!"

By default for most products, all users are allowed to use poses, but only the owner is allowed access to the OPTIONS menu and to adjust poses or turn posename chatting on and off. However, you can restrict access to the pose menus to owner-only or group-only, by editing the notecards that begin with .MENUITEMS (there will be one or more of these).

  • Wherever you see ALL next to a menu name, you can change this to GROUP or OWNER.

Landlords may wish to set the OPTIONS menu to allow GROUP access (rather than OWNER), so that renters can adjust poses. They will not be able to save them to notecards, and a reset will restore the original positions, for subsequent renters.

See also: ## What about group-owned land ##


HELP!

Q: In my inventory, my MLP Product says "no modify." So how can I edit the notecards, etc? A: Second Life permissions are somewhat primitive, and misleading at times even. In your inventory, the MLP Product object is showing as "no modify" because it has animations in it which are no modify. If even one item within an object is "no modify", the whole object will show misleadingly as "no modify." In truth, however, when you rez the MLP Product, you will see that you can edit it, change the texture, rename it, edit the notecards, etc.

Q: Sometimes, I click the MLP Product to start it up, and then when it's started and I click it again to use it, I get asked if I want to continue because [someone's name] has just selected the menu. A: Yep. We've seen that from time to time. Just click "Yes" to continue.

Retrieved from "https://wiki.secondlife.com/w/index.php?title=MLPV2_Users_Tutorial&oldid=1160146"