..: P L O R E H O design :: Luxace v1.1 :..
Luxace is a powerful and extremely versatile face lighting system, designed to help people take astonishing photo shoots, from normal amateurs to professional modeling ones.
In the box you will find 2 items. The first one is the face light itself, made up of 3 prims, 2 emitters and the root object containing the main control scripts and the *Configuration notecard.
The second item is the HUD used to control the emitters. The HUD attaches to the center HUD attachment point, placing itself on the central bottom part of your screen. Remember that you'll need to keep the HUD on just when you want to change the emitters parameters and configure new programs, in all other situations you can leave it detached.
..: What's new in v1.1 :..
- NEW: chat commands support! With a new parameter (CHATCOM_CHANNEL) in the *Configuration notecard, it is possible to enable chat commands instead of having to use the HUD for all the basic operations (see "Chat commands" paragraph later on)
- NEW: programs converter, dropping your old *Programs notecard inside the contents of the programs converter box, you'll get the new v1.1-compatible lines to replace in your Luxace *Programs
- NEW: rotations support, with the chat commands rotx, roty and rotz it is now possible to rotate the whole attachment along the 3 axis
- BUGFIX: fixed some really nasty bugs when trying to dump a large number of programs
..: Updating from v1.0 :..
There are changes that make the old *Configuration and *Programs notecards incompatible with v1.1, but fixing them is a very easy operation.
For what concerns the *Configuration notecard, just replace the HUD_CHANNEL and HUD_PASSWORD with the old values you had in your previous Luxace version, while for the *Programs notecard, inside the Luxace product box I provided a programs converter, here's how to use it:
1 - wear the old v1.0 HUD and emitters, and press the Show/Hide button to make emitters visible, right click on the emitters Root prim, select Edit, then click on "More" in the edit window (unless it's already expanded) and click on the Contents tab. Copy the *Programs notecard in your inventory
2 - rez the Programs converter item on the ground (it's a glass-like cube), right click on it, select Edit, then click on "More" in the edit window (unless it's already expanded) and click on the Contents tab. Drop the *Programs notecard you previously collected inside the Contents of the cube. You will receive on screen the new lines of your *Programs, DIVIDED PER PROGRAM.
Example:
----START BELOW THIS----
PROGRAM default
ROTATION <-0.000000, 0.000000, -0.000000, 1.000000>
light1:<0.00000, 0.35000, 0.25000>:<1.00000, 0.79608, 0.97255>:1.000000:2.000000:0.750000
light2:<0.07500, -0.34980, -0.25000>:<1.00000, 0.84706, 0.70980>:1.000000:2.000000:0.750000
----END BEFORE THIS----
You will have to copy just the part between the START BELOW THIS and END BEFORE THIS lines, and this for each program you had in your noecard
3 - wear the _new_ HUD and emitters, make them visible and replace the content of the *Programs notecard with the lines printed by the converter
..: First use :..
The basic thing you have to know before using Luxace: the HUD and the emitters root prim contain a notecard called *Configuration. Inside it there are the HUD_CHANNEL and HUD_PASSWORD settings. The first specifies the channel on which HUD and emitters will communicate (HUD_CHANNEL will be used for hud->emitters, HUD_CHANNEL+1 will be used for emitters->hud). The second one specifies the password using which each communication will be encrypted.
Luxace includes default settings which will enable your product to work as is, but we recommend to change both settings with something unique for security reasons, as explained in the notecard itself.
Also, bear in mind that SETTINGS OF THE HUD HAVE TO MATCH SETTINGS OF THE EMITTERS, or they won't be able to communicate between each other.
In addition, the emitters notecard also contains a CHATCOM_CHANNEL setting, specifying the channel to be used for standard chat commands (default is channel 5).
So, let's move on:
1 - wear both the object, the emitters will attach to the chin attachment point, the HUD will attach to the central HUD position
2 - change default settings: right click on the Root prim of the emitters, select Edit, then click on "More" in the edit window (unless it's already expanded) and click on the Contents tab. From there, double click on the *Configuration notecard, and change the HUD_PASSWORD and HUD_CHANNEL variables to a new value of your choice. Repeat the same editing the HUD and matching its variables values with the ones you specified for the emitters
3 - if you want, change the value of COMCHAT_CHANNEL with a channel of your choice inside the emitters configuration notecard
4 - Once the notecards are saved, you're ready to rock!
..: HUD interface :..
A - pressing this button will show/hide the emitters object. When showing, the emitters are quite big and visible, to allow for a perfect placement and configuration, while when hidden they are invisible and very tiny
B & C - these are the two movement controls for the respective emitters. Using the arrows you will move the emitters on the X and Z axis, while clicking on the 2 tinier lower-right arrows will change the Y position. Pressing the central button will reset the emitter in the default position
D & E - these are the two parameters controls for the respective emitters. Using the up/down arrow will let you raise and lower the Intensity, Radius and Falloff of the emitter, while pressing the central button will reset the value to its default
F & G - these are the two color controls for the respective emitters. Their use is explained in the next section of this manual
H - the Load button will allow you to select a saved program from a dialog in order to activate it
I - the Save button will allow you to save your current emitters settings to a program. You will have to choose a name for your program and announce it on channel 3, for example: /3 NewProgram . If the name you choose exists already, the program will be updated
J - the Canc button will allow you to delete the active program
K - the Dump button will write in your chat a bunch of lines containing the "description" of the current program settings. See "How to save programs permanently"
..: How to change the emitters color :..
Right click on the HUD, select Edit, click on "Edit linked parts" on the top left, then click on "More" in the edit window (unless it's already expanded) and click on the Texture tab. Click on Color and change the color of the two buttons to the color you want the respective emitter to cast. Once you have done this, close the Edit window and press the two buttons to propagate the new color to the emitters.
..: How to save programs permanently :..
Should the emitters reset for any reason, you will loose the programs you saved in its memory. In order to make the changes permanent, you will have to include your own programs in the *Programs notecard inside the emitters Root prim.
To do this, click on the Dump button, on far right end of the HUD. A bunch of lines will be printed on your screen, DIVIDED PER PROGRAM.
Example:
----START BELOW THIS----
PROGRAM default
ROTATION <-0.000000, 0.000000, -0.000000, 1.000000>
light1:<0.00000, 0.35000, 0.25000>:<1.00000, 0.79608, 0.97255>:1.000000:2.000000:0.750000
light2:<0.07500, -0.34980, -0.25000>:<1.00000, 0.84706, 0.70980>:1.000000:2.000000:0.750000
----END BEFORE THIS----
Now, right click on the emitters Root prim, select Edit, then click on "More" in the edit window (unless it's already expanded) and click on the Contents tab. Double click on the *Programs notecard. If you never edited it before, you will see the default programs included with Luxace. Delete them and start pasting the programs you printed on screen earlier, basically all the lines between the START BELOW THIS and END BEFORE THIS, for every single program. After this, save the notecard. The emitters will restart automatically, loading the new programs you just included.
IMPORTANT: the programs included in the notecard will be reloaded as default at EACH emitters reset.
..: Chat commands :..
Luxace supports a wide number of chat commands to operate the emitters without the need of having the HUD attached. Here's a list (using default channel 5 for communications):
- Movement commands (l1 to tell light1 to move, use l2 to move light2)
Right: /5 l1 right
Left: /5 l1 left
Up: /5 l1 up
Down: /5 l1 down
Far: /5 l1 far
Close: /5 l1 close
Reset the emitter position: /5 l1 default
All movement commands take as optional value the amount of meters you want the emitter to move, example:
/5 l1 right 0.3 - will move the light1 emitter on the right by 0.3 meters
- Rotation commands
Rotate 90° on the "x" axis: /5 rotx 90
Rotate 90° on the "y" axis: /5 roty 90
Rotate 90° on the "z" axis: /5 rotz 90
Reset default rotation: /5 rotdefault
- Programs commands
Save the current settings into a program named "test":
/5 save test
Load the program "hellish:
/5 load hellish
Delete the current program
/5 delete
Dump the programs list on screen
/5 dump
..: Product updates :..
You will automatically receive free updates to the product when they will come available. The update check is issued every time you wear your Luxace HUD.
..: Known issues :..
Occasionally, when wearing the HUD some of the buttons appear invisible, to fix it, just right click on any part of the HUD and the buttons will reappear again.
..: Users group and website
Ploreho design Clients - http://ploreho.blogspot.com
..: Support :..
To provide you with the best customer support service possible, your basics informations (such as AV name and key) will be stored in our databases in order to register your sale and allow us to operate the update system and send out global notices to our customers. Each connection to our web facility runs through a 256-bit secured connection certified by an official Certification Authority, and in no case your informations will be disclosed to a third party entity, but they will be used to the only purpose of customer support & technical informations. Should you have any more question regarding this, feel free to submit a request to [email]privacy@ploreho.com[/email].
Should you have any other problem, don't hesitate to contact me in-game (Gabriel Watanabe) or send an email to [email]support@ploreho.com[/email] detailing your problem and avatar name.
..: Credits :..
Biggest credit goes to Caliah Lyon for the initial idea on this. Without her, no Luxace at all, and no awesome suggestions like chat commands implementation further on.
The ideas behind the rotation comes from Cronocloud Creeggan, nice person and always up to help.
Stephanie Misfit for the betatesting and enthusiastic approach to this product.
Apollonia Bertolucci for the patience of being the very first unlucky tester and for having discovered some really nasty bugs.
Anya Yalin for some awesome ideas behind it, beta testing and revision of the user manual.
..: P L O R E H O design :..
