[SA] RLV Lamp Post

==================================================
                  ❍❍❍❍ ●●● [SA] Shades of Passion ●●● ❍❍❍❍
==================================================
                      ❍❍❍❍ ●●● [SA] RLV Lamp Post ●●● ❍❍❍❍
==================================================
                            ❍❍❍❍ ●●● [Version 1.0] ●●● ❍❍❍❍
==================================================
                           ❍❍❍❍ ●●● [Users Guide] ●●● ❍❍❍❍
==================================================

1. Use and Care of your lamp.
Be aware your new [SA] RLV Lamp Post is NO-COPY!  Be sure you take good care not to lose it.  We will not provide replacements.

Be sure to dust the cover at least once a week.

2. Menus

Be aware you CANNOT ACCESS the menu if you are sitting on the lamp!  The victim is never allowed to use the menu, even if the victim owns the lamp.

All menus contain a 'close' button.  This will deactivate your lock on the menu.  Menus are exclusive to one person and will not allow any one else to use the menu if someone is using it.  If they don't use the menu for two minutes, the menu will be released to another user.

------------------[ The Main Menu ]------------------
When you first touch your lamp, you will be given the 'no victim' main menu.  This menu contains the following options:

Capture...This will initiate a scan for anyone nearby with a open RLV relay and allow you to capture them!
Settings....Allows you to adjust various settings of the Lamp Post.  See below.

When there is a victim on the lamp, you will be presented with the 'victim' Main Menu.  This comes in two flavors, RLV and non-RLV.  When the victim has no RLV relay, the options you have are:

Release....Releases the victim (unsits them.)
Anim........Select a new animation for the victim.
Settings....Takes you to the settings menu as above.

When the victim has an active RLV relay, you will be presented with many more options on the 'victim' main menu, they are:

Unlocked/Locked.....Toggles the lock.  When locked, any RLV restrictions are enforced and recapture is used if enabled.
Anim.....As above, selects a new anim for the victim.
Settings....As above, takes you to the settings menu.
Release....As above, unlocks and releases the victim.

When locked, the following additional options are available:

Restrictions....Takes you to the RLV restrictions menu, see below.
Take Key.......Allows you to the take the key to the Lamp Post.  Whenever someone has the key, only they may use the menus.  Everyone else is locked out, except the owner.  If the owner uses the menu, they can use the 'Change Lock' feature to take back the key if they want, but this will also free the victim.
Timer.....Allows you to set a time lock for when the victim is to be freed automatically, see below.

------------------[ The Settings Menu ]------------------
By default, only the owner of the Lamp Post may access the settings menu.  This can be adjusted in this menu.

Based on who you are, you will see the following options:
Reset.....(owner only) Resets the lamp post's scripts.
Appearance....Takes you to the Appearance menu, where you can adjust various aspects of the Lamp Post's appearance, such as color, light amount, cover type.
Autolock....(toggle) When enabled, the lock will immediately be engaged when a victim with a RLV relay sits on the Lamp Post.
Recapture....(toggle)  When enabled, if the victim logs out while locked to the Lamp Post, it will enter recapture mode, refusing to let anyone else sit on it.  When the victim logs back in, the Lamp Post will attempt to recapture them.
Kick!RLV....(toggle)  When enabled, if the victim does not have an active open RLV relay, they will be kicked off the Lamp Post.
Sets Access....(toggle/owner only)  Toggles the Settings menu access between Group, Owner and All.
Menu Access...(toggle/owner only)  Toggles entire menu access between Group, Owner and All.

------------------[ The Anim Menu ]------------------
In the Anim (animations) menu, you can choose one a new animation to use.  If the person sitting on the Lamp is too high or low, you can use the Adjust Pos option to make adjustments.  Be aware adjustments are never saved and only apply until the lamp is reset.

The Anim menu also has a 'Back' button that will return you to the main menu.

------------------[ The Timer Menu ]------------------
In the Timer menu, you will see how much time is remaining on the time lock.  You can add amounts of time while its stopped or running.  The [Stop] button will pause the timer.  [Start] starts/restarts the timer.  When the timer reaches 0, the victim is released.  So if you push the 'reset' button, which resets the timer to 0, the victim will be released if the timer is already running.  [Back] takes you back to the main menu.

------------------[ The Restrictions Menu ]------------------
Here you will find all sorts of RLV restrictions you may impose upon the helpless victim.  By default the following restrictions will already be in place:
Teleport-LM..teleporting to a landmark
Teleport-Location..teleporting to a location
Teleport-Friend..teleporting to a friend
Teleport-Sit..using sit to move around
Stand..standing up.

Everything else is allowed, by default.  You can make adjustments in this menu to various restrictions, toggling them on and off.  A checkmark means the activity is allowed, an X means the activity is disallowed.

RLV restrictions are maintained between victims.  So if one victim is released, the next one will have the same restrictions as the last one.

If you use the 'next >>' button to go to the end of the menu choices, an 'allow all'/'disallow all' button is there at the last menu.  Should be obvious what this will do.

------------------[ Recapture and Timers ]------------------
When recapture is enabled, if the victim logs off, the time lock timer will be paused until they log back in.  So time lock time has to be passed while logged in.  Also, the main time locked timer is paused if the victim logs out, so it's an accurate measure of how much time the victim has spent online so far locked to the Lamp Post.

------------------[ Animations Note card ]------------------
You are more than welcomed to add additional animations to the Lamp Post.  Here I will show you the format of the note card:

# animation data store
# format:
# menuitem|animname|pos|rot|options
#
# options can be:
# lcuff=#       do LM chain from anchor point to lcuff.  anchor points 1 and 2 are both
#                   from the middle lock. 3 is the left lock and 4 is the right (when looking
#                   at lamp from behind, lock toward you.)  lcuff may be any valid LM anchor
#                   point.
# none          no lockmeister chains for this anim.
#
# at present no multi-level menus are support.  this is a very simple animation engine.
# lines starting with # are ignored, but still take time for the script work through, so
# keep comments to a minimum.

I use a SitTarget gadget to determine position/rotations of added anims.  You would like a copy of this gadget to add your own custom anims, just ask!

==================================================
==================================================
Copyright © 2011 Shady Accessories.
All rights to Artwork and Designs from Shady Accessories are Copyright © and belongs to Shaden Sura.
All Script work Belongs and is Copyright © to Chetar Ruby
==================================================
Need help or have a Suggestion contact: Shaden Sura or Chetar Ruby
==================================================