User Manual for Lighting System 1.7.5
Contents
1. YES prim color changes with light color changeParticleColor YES YES particle color changes with light color particleTexture texture UUID for particle effect particleMenu NO YES On Off replaced by Particles particle menu notecardMenu NO YES On Off replaced by Presets notecard menu YI lightGroups YES ES use description for light groups NO ignore description face 1 color glow fullbright on all faces 1 or just one baseIntensity 100 base percentage for light intensity Menu defaults colorOn lt 100 100 100 gt color percentage red green blue when ON coloroff lt 100 100 100 gt color percentage red green blue when OFF alphaOn 100 alpha percentage when ON alphaoff 100 alpha percentage when OFF intensity 100 light intensity percentage radius 50 light radius percentage falloff 40 light falloff percentage glow 0 glow percentage fullbright YES fullbright when ON YES or NO particleSize 20 size percentage for particle effect Link messages in msgNumber 10957 number part of incoming link messages msgSwitch switch string part of incoming link message switch on off msgOn on string part of incoming link message switch on msgOff off string part of incoming link message switch off msgMenu menu string part of incoming link message show menu Link messages out extButton extNumber On Off replaced by button te2. etc both ON and OFF settings are supported WARNING For a hassle free experience it is recommended to use a separate non root prim for the switch For the sake of clarity this prim should contain both switch and ext_config_control Note that the particle size will be read from the notecard If there is no notecard the default size will be used see CONFIGURATION NOTECARD You can still use the particle menu see PARTICLES to get an indication of what to enter in the notecard Finishing the product remove the switch the configuration notecard and the ext_config_control script replace them with ext_switch_control in the same prim touch for on off COMMUNICATION WITH OTHER SCRIPTS The switch can both send and receive link messages Sending create a custom menu button by entering a short text after extButton in the notecard replacing On Off in the menu When the button is touched it will send the number 10958 and the button text in a link message The message can be caught by another script within the same linkset The other script can call the main menu by sending the number 10957 and the word menu Receiving other scripts can control the switch and menu by sending the number 10957 and a command See CONFIGURATION NOTECARD for all possible commands Useful for plugins of which two examples are included nightlight and proximity Intercepting existing messages if you created a script and the need aris
3. SET MODE Now you can have multiple switches for a single light group Drop the link control script in any prim within the same linkset and the link receiver script into the prim where the switch is located Touch for on off long touch for menu Because a link control is part of a light group the prim description in switch light s and link control must be identical There can be several secondary switches but only one primary switch REMOTE CONTROL UNIVERSAL SECONDARY SWITCH The remote control can be used in both linkset and region mode A remote control can be anywhere within the same region Drop the remote control script in an external object and the remote receiver script into the prim where the switch is located Touch for on off long touch for menu Because a remote control is part of a light group the prim description in switch light s and remote control must be identical There can be several secondary switches but only one primary switch Every receiver has an open listener NETWORK CONTROL CONTROL PANEL FOR LIGHT GROUPS Drop the network control script in an empty prim and the network receiver script in every prim that contains a switch It can control up to 9 light groups turn them on or off all at the same time or pull up the menu for individual light groups Touch for menu There are two versions linkset and region When using the region version every receiver has an open listener ADVANCED CONTROLS T
4. USER MANUAL FOR LIGHTING SYSTEM Date 01 01 2015 Version 1 7 5 QUICK START Rez the Single prim example cube Touch to turn light on or off touch and hold mouse button gt 1 sec to show menu For a linkset example rez the Standing lamp and touch the stand TWO SCRIPTS SWITCH AND LIGHT Two menus main menu and color alpha menu The main menu only makes sense if the light is ON the color alpha menu comes in two flavours making it possible to set color and alpha for both ON and OFF states For example you can have a red and transparent light that turns green and opaque when off TWO MODES LINKSET AND REGION Linkset mode scripts can only function within the same linkset switch and light can either be in the same prim or in different prims there are no open listeners Region mode scripts can function anywhere within the same region switch and light cannot be in the same prim there is an open listener for every light Use linkset mode whenever possible and region mode only if there is no other option LIGHT GROUPS Lights can be grouped by setting the prim description in both switch and light s to the same word or phrase for example Bedroom or Kitchen Keep it short and sweet so the text won t scroll to the next line in the menu Use one switch for one light group If the description is empty or No Description both switch and light s will be in the Default group LINK CONTROL SECONDARY SWITCH FOR LINK
5. e the menu to set light color alpha etc both ON and OFF settings are supported remove the config control scripts for different light sources drop them in other prims and pull up the menu again if a prim was unintentionally marked as a light prim erase the description WARNING For a hassle free experience it is recommended to use a separate non root prim for the switch Finishing the product remove the switch the configuration notecard and all config control scripts drop switch_control in the prim of your choice touch for on off EXTENDED CONFIGURATION AND SWITCH CONTROL This is the extended version of the configuration and switch control The only difference is that it supports particles making light bulbs required Features switch replaced by very small script particle support Limitations linkset only no plugins no other controls no security no linking with other scripts one switch group All settings will be hard coded into the object End users can only switch the light on or off Scripts needed during configuration ext_config_control switch light particle script after configuration ext_switch_control light particle script Configuration set up your linkset in the usual way using one switch and one or more light scripts drop a particle script in one or more light prims drop ext_config_control in the switch prim use the menu to set light color alpha
6. es to perform some action when the light is switched on off or parameters are changed check for number 10957 PLUGIN SCRIPTS Regular plugins nightlight proximity go in the same prim where the SWITCH is located Particle plugins halo starburst go in the same prim where the LIGHT is located All plugins are compatible with both linkset and region scripts PARTICLES Rez the Example particle test lamp and touch it A small halo will appear around the bulb To try out other particle effects remove Particle Halo from the lamp and add another particle script by dragging it from your inventory Both adding and removing can be done with the light on or off The particle size can be changed in the particle menu or in the notecard Please note that you have to set particleMenu to YES in the notecard in order to use it The On Off button will be replaced by Particles There can be no more than one particle script in any light prim at any given time Every particle effect has its own minimum and maximum size The Min and Max buttons in the particle menu will resize the particles to the smallest and largest possible size for the current particle effect CANDLE FLAMES Candle flames always need a transparent prim to work The best way to accomplish this is using the default transparent texture Setting both Alpha values to 0 in the notecard will work as well but will allow changing the transparency from the color menu The flame w
7. g_control and ext_config_control 1 7 4 05 10 2014 slightly improved startup messages more efficient notecard loading 1 7 5 01 01 2015 access levels in notecard no longer require numbers new notecard option baseIntensity reduce overall intensity yet maintain full control new notecard option face limit color glow fullbright to one single face added face picker in Tools folder
8. he following controls require a fair amount of patience and may not yield the result you expect But they will save a lot of script memory LIGHT CONTROL LIGHT WITHOUT BULBS Useful in situations where many light bulbs are needed and you don t want to use a large number of scripts Imagine a switch and half a dozen light bulbs seven scripts altogether You can reduce this to two scripts by not using any light bulbs at all and dropping switch and light control in the same prim Before you flip the switch set the prim description of the switch and use the same description for all prims you intend to use as a light source If you don t every single prim in the linkset will be lit possibly with the exception of the switch see below Limitations linkset only no particles The switch itself won t light up unless it s the only prim or the root prim CONFIGURATION AND SWITCH CONTROL Features one tiny script for any number of light sources every light source can have its own settings Limitations linkset only no particles no plugins no other controls no security no linking with other scripts one switch group All settings will be hard coded into the object End users can only switch the light on or off Scripts needed during configuration config_control switch after configuration switch_control Configuration drop switch in a child prim and config_control in every prim you want to use as a light source us
9. ill default to white You can either change this in the Color menu or in the notecard Using the notecard is the preferred method An example with candle specific settings is included TEXTURES Several textures have been included as a replacement for the default particle texture Use them to improve the quality of candle flames or as halo textures How to obtain a texture UUID right click on a texture in your inventory choose Copy Asset UUID and paste it into the notecard How to preload a texture apply the particle texture to a single face of your product somewhere out of sight so it will be loaded before you turn on the light TOOLS In the Tools folder you will find the following scripts Color converter converts RGB colors to the format used in the notecard Face picker identify face numbers by touch Remove floating text removes floating text from examples TROUBLESHOOTING WHY DON T I SEE ANY LIGHT unless you have advanced lighting enabled the viewer can only handle 6 light sources at a time see the following forum post http community secondlife com t5 LSL Scripting Light script m p 1710339 M13791 description of switch prim and light prim s are not identical prim description was accidentally entered in name field incompatible script modes linkset region are used together the nightlight plugin turns off light during the day is begin used CONFIGURATION NOTECARD The switch script uses a no
10. mode remote control secondary switch for REGION mode network control control panel for multiple light groups bugfix link messages from plugins could bypass access control 1 6 1 07 09 2013 bugfix initial particle size too small minimum instead of default 1 6 2 24 12 2013 This is a bugfix release All changes pertain to the network control and are the result of user feedback added linkset version region version is inconvenient for rentals removed access limitation owner group inconvenient for rentals fixed node discovery sometimes incomplete depending on rez order fixed sorting of menu buttons 1 6 3 12 01 2014 added color converter RGB to notecard format in Tools folder cosmetic changes in network control 1 7 24 01 2014 support for up to 11 configuration notecards light control light without bulbs user definable extension button 1 7 1 21 03 2014 configuration controls configure individual light bulbs store settings save script memory bugfix notecard menu not showing when menu is called from plugin bugfix notecard menu pops up if object is touched before notecard has finished loading bugfix changePrimColor changeParticleColor NO notecard using white should be off color removed all debug code final code cleanup 1 7 2 17 08 2014 the use of light groups prim description can now be disabled in the notecard 1 7 3 24 08 2014 rounding error in confi
11. tecard default name config Default with some lesser used but powerful options The notecard is optional If not present default values will be used as indicated below There can be up to 11 notecards The naming convention is config Name If you intend to use more than one notecard set notecardMenu to YES The On Off button will be replaced by Presets and all available notecards will appear in a menu For faster loading remove whatever lines you don t need do not remove notecardMenu YES In 1 7 2 the lightGroups parameter was added so the group feature can be turned off If this parameter is set to NO the prim description will be ignored and everything will be in one single group one switch and one or more lights None of the control scripts can be used in this setup The baselIntensity parameter requires some further explanation When using many light sources in close proximity you will be forced to lower the intensity in order to prevent light flooding leaving you with very little flexibility By setting the baseIntensity instead you will maintain full control 0 100 while the overall intensity is lower verbose YES show more less info during startup switchAccess PUBLIC access level for switch PUBLIC GROUP OWNER GROUP OWNER menuAccess PUBLIC access level for menu PUBLIC GROUP OWNER GROUP OWNER menuPercent 10 increase decrease percentage for buttons changePrimColor YES
12. xt sends link message 10958 number part of outgoing link message ACCESS CONTROL Both switch and menu have 4 access levels public group owner and group owner For example you could have a public light switch with limited access to the menu so no one can mess with your settings Access levels PUBLIC anyone GROUP avatars with same active group as object OWNER object owner GROUP OWNER group members and owner SILENT STARTUP Near the top of almost every script you will see the following line integer silent FALSE silent startup Even with verbose set to NO you will still see some whispers during startup For a completely silent startup set silent to TRUE CHANGE HISTORY 1 0 01 08 2011 initial version 1 1 30 04 2012 changed license from CC BY SA to CC BY added license notecard configuraton notecard and examples bugfix light script not resetting on rez due to state change 1 2 20 05 2012 access control owner group public 1 3 02 02 2013 added additonal permissions to license particle effects menu defaults enable disable prim color 1 4 24 02 2013 optional particle menu particle texture enable disable particle color 1 5 31 03 2013 textures moved verbose setting to notecard bugfix particle resizing buttons not responding 1 5 1 17 05 2013 removed author name from configuration notecard 1 6 31 05 2013 link control secondary switch for LINKSET
Download Pdf Manuals
Related Search