Graphics In Secondlife

Scripts:

~ball
~pose
~pos
~memory
~menu
~pose1
~pose2
~run

Notecards:

.POSITIONS
.readme
.MENUITEMS

Animations:

solo
hug-masculine
hug-feminine
splat

Objects:

~ball

MLP - MULTI-LOVE-POSE V1.11 - Copyright (c) 2006, by Miffy Fluffy (BSD License)

The BSD Licence allows anybody to use the source code, in any manner they wish, providing that they provide the copyright notice above on further distributions.
So it's totally free, however if you like it, I would be very happy if you donate any L$. If you're using significant parts of this code in commercial products, I would appreciate if you donate me at least L$1 for each sold product (preferably more
I won't give support, however I'll make an exception for end-users that donated L$1000 or more (for commercial support, custom versions, contact me).
To donate, go to my profile (Find - People - Miffy Fluffy) and use the "Pay..." button, thanks!
You can also find the link to the latest version here.

NOTE: users of previous versions (before V1.04) who want to use their old .POSITIONS notecard with this version have to convert this notecard with the "~~position conversion tool" located in MLP, drag it into the world and follow instructions.

FEATURES:
- Put all your poseball animations into one object (50 pairs or even more should be no problem).
- Create submenu's for each category of poses, for instance: "Lovers, Boy-Girl, Girl-Girl, Self, Solo, Dance"
- Shows 1 or 2 poseballs depending on the submenu you select
- Positions can be adjusted and saved into memory (backup is easy: select Memory Dump and copy-paste into notecard)
- Portable, can be worn and used everywhere
- Option to adjust height offset (Z) of all poses at once (for different persons/locations).

OPERATION:
- Click the MLP object to switch it on
- When everything has loaded click again for the menu
- Select a submenu containing poses, poseballs will appear automatically
- Sit on your poseball (Right-click - POSE)
- Select a pose, the animations will start
- To stop: select "STOP" or "STAND"
- To remove the balls: press "STOP" (or "STAND") again
- To switch-off: select "Shut Down" twice (but you can leave it on after use).

TO ADD ANIMATIONS:
Copy all animations into the MLP object (if you want to use existing poseballs, open them to rip their animations). Note: you can use any object as MLP, just copy the MLP contents in the object of your choice.
Open the .MENUITEMS and add the animations:
POSE name | animation1 | animation2 (see examples in .MENUITEMS)
The changes will become active after MLP is (re)started.

TO ADJUST POSITIONS:
Select a submenu containing the pose you want to adjust, sit on the balls and select the pose you want to adjust.
Go back to the main menu, select "Options - Adjust Pos", this way the balls are changed into transparant beams. Right-click a beam, select Edit to adjust the position (hold Shift to select both beams). You can position the balls anywhere within 10m from the MLP object.
"Save Pos" will store the position into memory.

TO MAKE A BACKUP:
The positions will still be kept in memory after shutdown/restart or when the MLP is put back in your inventory. The positions will be lost only when the memory script is reset (or when it crashes f.i. when it's too full: "Script run-time error / Stack-Heap Collision"). A backup can be made on the .POSITIONS notecard, when the memory is empty it will read the .POSITIONS notecard automatically.
To make a backup select "Mem Dump", copy the complete dump (from Chat-History) and paste it into the .POSITIONS notecard (just replace everything, you don't need to edit/format anything).

TO ADJUST HEIGHT OFFSET (Z):
Select "Options" and click the "Z"-buttons, this will adjust the height for all poses. (Note: the offset height is stored in the Object Description in cm, so any descriptions will be replaced).

USER ACCESS TO THE MENU:
The owner is the only one who can start/restart/shutdown/save, in all cases.
If "Options - All Users" is set ON, anyone can operate the main menu, but access to individual submenus can still be blocked (you can define access for each submenu in .MENUITEMS, see examples in .MENUITEMS).

PORTABLE USE:
Attach the object to the HUD, you can use it's default shape and color for clickable bar on one of the edges of your screen (to move HUD position: Right-click - Edit), you can make it invisible too (MLP menu: "Options - Invisible").
Adjust the height offset (Z). Note: the balls will appear relative to the initial MLP position (to reset where the balls appear press STOP twice and reselect a submenu containing poses).
Instead of attaching it to the HUD, you could also wear it, change the object into an invisible ball of about 0.5m diameter and wear it on your pelvis (if that's free, or hip, but that's not always leveled when standing). This way your partner could operate the menu by clicking your ass (if "Options - All Users" is switched ON).


FAQ:
- Will my animations be lost if I loose a poseball?
No. The animations are not placed the balls, they remain in the main MLP object. Don't worry about the poseballs, they are copies of the one in the MLP object. A balls will commit suicide if left behind somewhere (the MLP object needs to be within 10m).

- Sometimes notecards or scripts won't open for editing, why?
If the MLP contains many animations, access to it's contents can be slow, try again after a few seconds.

- "Script run-time error / Stack-Heap Collision"?
When it happens during loading: probably there are too many items in .MENUITEMS
When it happens during saving a position: the memory is full. If you do a reset (select: Tools - Reset Scripts in Selection), the backup on the .POSITIONS notecard will be loaded. (The Linden Scripting Language currently needs a lot of overhead memory during a 'save', which is the limiting factor for the number of poses that we can store, probably this will improve in the future. If you have saved a lot of positions (more than 50 or so), make a backup often (after saving a few positions), and do a reset after making the backup, this way the memory is optimized again and you can store more positions.)


CHANGES IN MLP V1.11:
- shame on me, fixed a mistake I made which caused the balls to dissappear within 60 seconds, sorry. If you have V1.1 already you only have to replace the ~ball inside MLP, delete the old one and drop in the new one.

CHANGES IN MLP V1.1:
- selecting "STAND" doesn't hide the balls anymore (to avoid confusion)
- adjusted sit height on the balls, so the balls will remain visible with most objects
- included a "position conversion tool" for users of previous versions (before V1.1), also useful for those who've edited the SitTarget height in the ~ball script, no need to reposition all balls
- altough not really necessary, I've added the possibility to SHOW/HIDE the balls via the menu (you can add a SHOW and/or HIDE button somewhere in the .MENUITEMS notecard)
- fixed the reading of the .POSITIONS notecard, the new timestamps in the Chat-History memory dump gave problems
- improved menuacces: selections from previous menudialogs will be disregarded (avoids problems with multiple users too)
- owner gets a message if another user operates the menu (so you can avoid operating at the same time)
- reduced load: no timers are running anymore when no balls are rezzed
- with Save Position, the positions could be totally wrong sometimes (large distances), this problem is hard to track as it occurs sometimes only, i found a probable cause, so hopefully it's doesn't happen any more, please report, thanks.


Please report any bugs, or improvements in efficiency without loosing readability of the code (In many instances I've chosen readabilty over speed or size because I think it's reasonable to expect that the compiler will improve in the future). If you want to read the code start reading the comments in ~run for an overview. The source code used in ~menu is partly based on the Menu Engine by Zonax Delorean (BSD License), thanks. I included some free poses as examples, thanks to their makers. Thanks to Purrcat Miranda for testing with me Thanks to other creative people in SL too, and thanks for any donations. Have fun!

MLP - MULTI-LOVE-POSE V1.11 - Copyright (c) 2006, by Miffy Fluffy (BSD License)