Linden text version 2
{
LLEmbeddedItems version 1
{
count 0
}
Text length 16795
***********************
***********************

      MWS HoloScene 1.0

***********************
***********************

NOTE.
====
From March 29, 2009; HoloScene 1.0 is an Open Source and Free product.

¡¡¡ PLEASE READ LICENSE BEFORE TO USE HoloScene 1.0 !!!

***** Those who have bought HoloScene in the past will continue receiving support from MWS.

--------------------------------

HoloScene is a system that will allow you to store and change the scene or decoration of your room, your house or another places in a few seconds. You can build several decorations for the same place, store them inside the pad of HoloScene and then change between them easily using the HoloScene menu.

----------
Features.
----------

    - Can store up to 30 decorations or scenes in the same pad.
    - It have two rezzing modes. "Normal" and "Instant".
    - In "normal" mode you will see how objects are rezzed from the center of the HoloScene pad and then they move until they reach its final position. In "instant" mode, objects are rezzed directly in their final position. To be able to use "instant" mode, at least the parent prim of one of the objects in the scene have to be not far than 10 meter from the center of the HoloScene pad.
    - Easy configuration.
    - Can be configured to be used only by the owner, or by members of the same group as the pad, by members stored in a "friend list" or by everybody.
    - It can rezz objects up to 90 meters around the center of the pad.
    - The pad can be hided.

-------
Notes.
-------

    - Objects can not be rezzed underground. If some object is rezzed underground it is posible it get locked and it will not move to its final position. Is posible you need to use "UnSTK" option inside menu or to delete it manually and to rezz the scene again. To avoid this use "instant" mode if posible.
    - Be sure that every object will be rezzed inside the same SIM. If some object tries to move to an adyacent SIM you can get unpredictable results.
    - Rezzed objects can get locked too if they try to move inside a parcel (neighboring parcel) that have objects placing restricted. In this case it is posible you need to delete locked objects manually. Try to use "instant" mode.
    - Be sure you use object with COPY and MODIFY permissions. NO-COPY objects will rezz only one time and will be removed from the content of the pad. When you use "Clean" option, No-COPY objects will not be deleted for security purpouses and to avoid you lose them. You will need to delete or take them to your inventory manually. Objects have to be MODIFIABLE because you have to put a script inside every object.
    - Realize that HoloScene is not a "temporal rezzer" or an holographic vendor.
    - Objects positions are stored relative to pad position. If you move the pad, final position of every object will change too.

------------------------------------------------------
Storing scenes or decorations inside HoloScene.
------------------------------------------------------

    1 - Place an HoloScene pad in SL. Remember you can rezz object up to 90 meters around the center of the pad. 
    
    2 - Edit its configuration notecar and adjust the pad number, the use permissions and if you want to use a "control panel" adjust proper value (For more information about configuration read "Configuration Notecard" and "Control Panel" sections).
If you edit the configuration notecard remember you have to restart the pad using menu. Touch the pad and then select options "OWNER.Ops" ---> "Config" ---> "C.Refresh".

    3 - Build your scene or decoration placing objects around the pad.
    
            ***** REMEMBER. Objects used in the scene have to be COPYABLE and MODIFIABLE.

    4 - Once you have finished to build your scene, put a copy of the script "__MWS HoloScene 1.0 (slave)" inside every object of the scene. Be sure you put only ONE copy of the script inside every object.
    
    5 - Touch the pad (or the control panel if you use it) and select menu option "OWNER.Ops" and then select "Record". Wait a few seconds while every object record its position. Follow instructions in chat.
    
    *** ----------- ***
    
    HoloScene system will tell you in chat how many objects are in the scene and how many prims you are using in the scene.
    If the pad detects an object inside 10 meters range it will give you information needed for the "Scenes Configuration notecard". You will need to put this information in the notecard if you wan to rezz this scene in "instant" mode. Realize that you are not obly to use a "Scenes Configuration Notecard". You will need to use it only if you want to rezz some scenes in instant mode. And you will need to put in the notecard only those scenes you want to rezz in "instant" mode.
      
Example:

    MWS HoloScene 1.0 (PAD): ***************************
    MWS HoloScene 1.0 (PAD): Recording... Please Wait...
    MWS HoloScene 1.0 (PAD): ***************************
    MWS HoloScene 1.0 (PAD): ***** STORED:
    MWS HoloScene 1.0 (PAD): *****3 OBJECTS.
    MWS HoloScene 1.0 (PAD): *****3 TOTAL PRIMS.
    MWS HoloScene 1.0 (PAD): ***** At least ONE object inside 10m range. *****
    MWS HoloScene 1.0 (PAD): >>> For Instant Rezz put next line in objects notecard:
    MWS HoloScene 1.0 (PAD): +:name_of_object:<-1.13958, 0.09921, 0.24500>:<0.00000, 0.00000, -1.00000, 0.00000>
    
    If you want to configure this scene for "instant" rezzing you will have to select one of the objects first, before to select another object.
    How to know wich object you will have to select first ?
    Touch the pad and select option "OWNER.Ops". Then select option "Up.FIRST". You will see how one of the objects goes up 0,5 meters over its initial position. That is the object you will have to select first if you want to use "instant" rezzing. Every time you select "Up.FIRST" option the object will go up 0,5 meters more. If you want to return the object to its intial position (not necesary) you can select "Down.FIRST" or wait 20 seconds until the object returns by itself.

NOTE. That distance from one object to pad is not measured from the object itself but from its parent prim. If you see that you have an object inside the 10m range and you don´t get information for "instant" rezzing while recording positions that is because the parent prim of the object is not inside the 10 meters range.

    *** ---------- ***

    6 - Select every object in the scene. If you will use "instant" rezzing for this scene, remember wich object you have to select firts. To select all the objects in the scene, first edit the first object... then, while you maintain the SHIFT key of you keyboard pressed, move the mouse pointer over every object in the scene and select them.

    7 - Once you have all objects in the scene selected, take a copy a copy of them to your inventory. Put the mouse cursor over one of the objects, press right button of the mouse. When PIE menu appears selec MORE option at the bottom of the menu, and then select "TAKE COPY" option in the second PIE menu.

    8 - Edit the HoloScene pad. Look in your inventory for the copy of the scene you toke, you will see it as a simple object. Place a copy of it from your inventory to the content of the HoloScene pad.

    9 - If you will use "instant" rezzing for this scene, don´t forget to put data you got during positions recording inside the "Scenes Configuration Notecard"
    
    10 - Touch the pad. Select "OWNER.Ops", then select "Config" options and then select "C.Refresh" to force the pad to actulize its scenes list.
    
    11 - Now, you can delete objects of the scene manually or using menu. Touch the pad, select "Scenes" option and then "Clean" option.
    
    *** Repeat steps 3 to 11 for every scene you want to store inside the HoloScene pad.
    
    **** NOTE. Option "OWNER.Ops" will be only accessible by the owner of pad independently of use configuration.
    
    **** NOTE. The name of every scene when it is inside the pad can not be more than 20 characters long.

--------------------
Use of HoloScene.
--------------------

Follow next steps to use HoloScene once you have some scene stored inside it.

    1 - Touch the pad or the control panel if you are using it.
    
    2 - When menu appears select option "Scenes". Then select option "Rezz". And then select the scene you want to rezz form the list of scenes that are shown as buttons in the menu.
    
    **** NOTE. Sometimes, if there is too much lag in SL, it is possible that objects rezzed don´t move to its final position. Then you will need to use "UnSTK" option inside the menu ( "Scenes" --->  "UnSTK"). The objects will go up 50meters and then they will move to its final position. If this doesn´t work, then will need to delete objects and rezz the scene again.

    3 - Use options "Scenes" --->  "Clean" if you want to remove the scene.
    
    ¡¡¡ REMEMBER !!! that those objects that don´t have COPY permissions will be not deleted to avoid you lose them. You will need to delete them or take them to you inventory manually.
    
----------------
Control Panel.
----------------

A control panel is given to you with the HoloScene pack. It can be useful if you want to hide the HoloScene pad or when objects of some scene hide the pad and make subsequent acces to it more difficult.
If you want to use it, place a copy of the control panel not far away than 90 meters from the center of the pad.
Every control panel have its own configuration notecard. It have the same name that the configuration notecard used inside the pad but only one value inside it is important. If you want you can place a copy of the notecard inside the pad, inside the control panel.
Be sure, that the pad number configured in its notecard, and the number configured in the notecard inside the control panel are the same.
Read "Configuration Notecard" for more information.

---------------------------
Configuration Notecard.
---------------------------
 
 The HoloScene pad and the control panel use both a configuration notecard in wich yoy can adjust some parameters and permissions for its use. The name of the notecard is thte same for both and it have to be "_holoscene_config".

Parameters used inside the notecard are the next:

    - padnumber. Set the number of the pad and the control panel with this parameter. If you will use more than one HoloScene systems inside a range smaller than 90 meters be sure you put a different number for each of them to avoid crosstalk.

        This parameter is the only parameter needed inside the notecard of the control panel. 
        
        Example:
        
        padnumber:123
        
        in this example, number for the panel and the pad will be 123.
        
        
    - usecontrol. If you need to use a control panel with you HoloScene pad, set this parameter to 1.  If a control panel is not needed set this value to 0. I you make this value equal to 0 and you use a control panel; the pad will not comunicate with the control panel.

    Example:
    
    usecontrol:1
    
    in this example, its value is set to use a control panel.

    - onlyowner. If you put 1 to this parameter, don´t matter how other parameters are configured; only the owner will be allowed to rezz stored scenes.
    
    Example:
    
    onlyowner:1
    
    in this example, only the owner is allowed to rezz scenes.

    - group. If this is equal to 1, members of the same group as the pad will be allowed to rezz scenes. 

    - @. This symbol is used to add the name of avatars to a friend list. Those in the list will be allowed to rezz scenes.
    
    Example

    @:Woolich Ulich
    @:Marilyn Monroe

    In this example, avatars Woolich Ulich and Marilyn Monroe are added to the friend list and they will be allowed to rezz scenes.

    Permissions table.
    --------------------

onlyowner    group       some friend in the list?      PERMISSIONS
 
 1                  X                   X                                           only the owner (dueño) can rezz scenes. don´t matter how other parameters are configured.
 0                  1                   NO                                       members of the same groupand the owner are allowed to rezz scenes.
 0                  1                   YES                                      avatares added to the friend list, members of the same group and the owner are allowed to rezz scenes.
 0                  0                   YES                                      only members added to the friend list and the owner are allowed to rezz scenes.
 0                  0                   NO                                       everybody can rezz scenes.
 
    ***** REMEMBER. To follow sintax. Don´t place extra spaces at the begining or the end of the line. Don´t place spaces between parameters, values and ":" symbols.

------------------------------------
Scenes Configuration Notecard.
------------------------------------

To use an Scenes Configuration Notecard is not mandatory but it is needed if you want to rezz some scenes in "instant" mode.

Those scenes inside the pad that don´t have data about it inside the notecard will be rezzed in "normal" mode

For those scenes you want to rezz in "instant" mode, at least the parent prim of one of the objects in the scene have not far away than 10 meters from the center of the pad. And you have to put data taken while recording objects positions inside the Scenes Configuration Notecard.

For every scene you want to rezz in "instant" mode you will have to add a line in the following format.

    +:name_of_object:<-1.13958, 0.09921, 0.24500>:<0.00000, 0.00000, -1.00000, 0.00000>
    
This data is provided by the pad, in chat, during recording of objects positions.
    
The name of the Scenes Configuration Notecard have to be "_holoscene_objects".

    ***** NOTE. Some example notecards are provided with the HoloScene pack.

----------------
Menu Options.
----------------

MAIN MENU        _____________________________________________________
                                    |                                                                                                                   | 
                                    |                                                                                                                   |
                            Scenes______________________                                                  OWNER.Ops__________________________
                                            |                       |                        |                                                  |                   |                   |                   |                   |
                                       Rezz               UnSTK             Clean                                          Pad            Config        Up.FIRST   Down.FIRST     Record
                                                                                                                                         |          |           |       |
                                                                                                                                Show    Hide  C.Show  |
                                                                                                                                                                        |
                                                                                                                                                                    C.Refresh
                                                                                                                                                                    
    Scenes >>> Rezz : Rezz scenes.
    Scenes >>> UnSTK : Try to unlock objects locked by lag, or moved into nearby regions that don´t allow objects entry.
    Scenes >>> Clean : Delete the actual scene.
    
    OWNER.Ops >>> Pad >>> Show : Show the pad.
    OWNER.Ops >>> Pad >>> Hide : Hide the pad.
    OWNER.Ops >>> Config >>> C.Show : Say actual configuration in chat.
    OWNER.Ops >>> Config >>> C.Refresh : Refresh configuration, force the pad to refresh its configuration and scenes list.
    OWNER.Ops >>> Up.FIRST : Move FIRST object up.
    OWNER.Ops >>> Down.FIRST : Restore FIRST object to its initial position.
    OWNER.Record : Record position of every object in the scene.
                                

-----------------
Customization.
-----------------
 
    The pad and the control panel are sold with MODIFY permissions, if you want you can personalize them changing textures.

If you need more information or some help, send IM or notecard to:

Woolich Ulich.
}
 