Linden text version 2
{
LLEmbeddedItems version 1
{
count 0
}
Text length 4957
LAND EDITOR 2.1 NOTES
=====================
This version of the Land editor (LE) is a rewrite of the code originally created by JIM LANATE and STRIFE ONIZUKA for use in Second Life, and later listed in the OSGRID forums. It has been formatted for clearer reading, and various functions have been changed in how they work to allow for more information and clarity about which brush is being used. Extra modes of use (ONCE and MOVE) have also been added and there's now a choice of three themes. This have been done by LAURA ESS within an Open Simulator environment.

MANIFEST
~~~~~~~~
This distribution should include:

* A copy of the "Land Edit 2.1 (Single)" prim, which
  contains a copy of the Land Editor 2.1 script,
  three sets of 7 texture files for use as skins,
  and copies of the help and notes notecards;
* One or more examples of LE linksets;
* The LAND EDITOR NOTES note file (this note);
* The LAND EDITOR HELP note.

MENU CHANGES
~~~~~~~~~~~~
* LEVEL is now called FLATTEN. This is purely
  aesthetic, so that no action starts with the same 
  letter (for use with minimal skins);
* HELP and RELEASE NOTES are now included within
  the prim (they were non-existant in previous 
  versions being circulated);
* STOP is now OFF, and ONCE, MOVE and ON
  have been added to make usage more versatile.
* The SIZE sub menu is renamed to OPTIONS and 
  includes buttons to change theme and give the user copies of HELP and RELEASE notecards.

This means that the menu has six actions to chose from, four modes to use in, and two extra functions (GROUND an SIZE) for a total of 12 buttons. The OPTIONS sub menu has 9 items. 

MODES
~~~~~
There are now four modes of use for each LE which affect how and when an ACTION is applied by the BRUSH.

* OFF: No action happens whether the prim is 
  stationary or moving. The default initial setting;
* ONCE: An action happens every time it is
  selected via the menu;
* MOVE: An action happens every time the 
  position of the LE prim changes;
* ON: This is the old default mode of the LE prim.
  the action is constantly applied whether it is moved or not.
       
FLOATING TEXT & SKINS
~~~~~~~~~~~~~~~~~~~~~
Each LE now has floating text with shows the ACTION, MODE, and SIZE it is current set to, X,Y, and Z positions of the prim, and the land height underneath the prim. This is set by the update_Title user function, and each mode can have a different colour of floating text for clarity.

The original LE changed colour depending upon the size of the LE prim, but I found that made it hard to read any textures on the LE prim. This version replaces the skin texture instead, on all faces  (one texture for each ACTION) except for the bottom face, which is set to black. The update_skin user function is used to do this. The alpha channel and full bright are set depending on the MODE: 

* OFF                    Fullbright is off, and alpha at 50%;
* ONCE & MOVE  Fullbright is off, and alpha at 0%;
* ON                     Fullbright is on, and alpha at 0%.

CUSTOMIZATION
~~~~~~~~~~~~~
There are three sets of skin thems included: Colour, Symbol, and Mono. Each attempts to represent the LEs ACTION in different ways. 

You can change the skin UUIDs at the top of the  code (skinRevert, skinRaise,  skinLower,  skinFlatten, skinSmooth, skinNoise, and  skinBlank) to customize the appearance of the LE prim for each action operation, and a blank grid (skinBlank) used for resets.  

if you want to create new and diffent themes you'll have to make them yourself. I used a 512x512 px image for my thems but you could use 256x256px image just as well. You'll need one texture for each action + one for the blank, and name them as 
"skin[Set]Action" (e.g. skinOneBlank) so that they replace textures already used in the script. Set one is always the default. Then uload the replacements, and texture by texture copy their UUIDs over to the code.  You'll also need to rename the theme in the code.

Only text and graphic elements within the central four squares (the middle 126 px in a 512x512px texture) are guaranteed to be seen in all sizes. 


You can also change the colours used for the title text (TitleOFF, TitleONCE, TitleMOVE and TitleON) to whatever you want. 

WARNINGS
~~~~~~~~
* The LE 2.1 is a free tool and if you paid for   this you should 
   ask for your money back! 
* The LE emulates the EDIT TERRAIN tools available   in the 
   EDITING window of the viewer. As such it's just as dangerous 
   as the tools there. If you are   using an LE in ON mode 
   terrain can be changed very quickly. It is a good practice to 
   BAKE a Sims terrain just in case - see the help file.
* There is No guarantee that this will work   entirely as it should 
    - USE AT YOUR OWN RISK. 

FEEDBACK 
~~~~~~~
Feedback on improvements is always welcome. You can give feedback to LAURA ESS by visiting the SECONDS GRID Facebook page, or leaving a message in the Seconds Grid Info Hub.

[END OF NOTE]}
 