Revision as of 11:32, 17 January 2013

LightShare

The LightShare module allows region owners to get and set Windlight settings for their specific regions using in-world scripts, and for those regions to send those settings down to all, or specific, LightShare-aware viewers who visit the LightShare configured regions.

Enabling LightShare in OpenSimulator

LightShare core functionality is available within OpenSimulator 0.7 onwards.

The regionwindlight Database Table

A database table "regionwindlight" is used to store the settings.

OpenSim.ini Settings

LightShare is enabled by changing OpenSim.ini for the OpenSim.exe serving the regions you wish to use LightShare in:

• setting enable_windlight = true in the [LightShare] section of OpenSim.ini
• setting AllowLightShareFunctions = true in the [XEngine] section of OpenSim.ini

These changes affect all regions served by the specific OpenSim.exe which load this ini file.

Exmaple OpenSim.ini changes:

 [LightShare]
 ; This enables the transmission of Windlight scenes to supporting clients, such as the Meta7 viewer.
 ; It has no ill effect on viewers which do not support server-side windlight settings.
 ; Currently we only have support for MySQL databases.
enable_windlight = true

and

[XEngine]
 ; Allow the user of LightShare functions
AllowLightShareFunctions = true

Note: You can use Lightshare/Windlight scripts in your Regions but permanently saving those Lightshare/Windlight settings is not supported while using Sqlite Databases. When you restart the Region the settings are gone.

LightShare-Enabled Viewers

Updated virtual world viewers are needed to receive Windlight settings sent by a region through LightShare.

You must also have an updated viewer in order for LightShare scripting functions (see below) to be properly compiled, and show correctly in the script editor.

Imprudence Viewer

LightShare support is disabled by default in Imprudence.

To enable it, choose the "Edit" menu item, "Preferences" menu option, "Advanced" preferences tab.

Then, change the "Allow region Windlight settings (LightShare)" option.

Imprudence Viewer is available from:

• http://imprudenceviewer.org/

More details of the options are at:

• http://imprudenceviewer.org/wiki/LightShare

Meta7 Viewer

The Meta7 Viewer is compatible with LightShare regions. !!! It is unknown if Meta7 can work with the OpenSimulator ls* script functions detailed below. !!!

• http://www.meta7.com/download.php

Additional Note January 2013: The META 7 pages are offline. There is also no Reference or cached pages on the Waybackmachine [1]

Singularity

Singularity is a SL/Metaverse viewer, supporting many OpenSim-specific features, as well as Windlight/LightShare. It has full support for the OPENSIM Windlight script parameters. If you are into Windlight use this Viewer.

Website: http://www.singularityviewer.org/

Download: http://www.singularityviewer.org/downloads

TeaPot Viewer

Armin Weatherwax Teapot Viewer also supports Windlight. ! BUT it DOES NOT pick up the OPENSIM Windlight parameters from scripts.

You can edit Windlight settings in the viewer and save them to a notecard. You can give those Notecards to other people. The Notecards have a XML structure. You can also save windlight settings to your Harddisk and share those seetings e.g. by email or via a Website. The path for those windlight files on your Harddisk is YOURDRIVELETTER:\Program Files (x86)\Teapot\app_settings\windlight (on Windows)

Website: https://bitbucket.org/ArminW

Download: https://bitbucket.org/ArminW/teapot/downloads

LightShare Scripting

The features can be used through three LightShare (ls) functions:

• lsGetWindlightScene
• lsSetWindlightScene
• lsSetWindlightSceneTargeted
• lsClearWindlightScene
• LightShare Parameters

See also the DefaultLightShareScript to get a starter script.

• txOh has created an in-world LightShare controller, which allows you to easily set custom LightShare settings. An IAR with the controller can be downloaded from http://www.gridhop.net/IAR/lightshare.iar

See Inventory Archives for an explanation of how to add the contents of the IAR file to your inventory.

LightShare Issues

• http://opensimulator.org/mantis/search.php?project_id=1&search=LightShare&hide_status_id=-2

See Also

• RestrainedLove API [2] @setenv and @getenv commands
• Phoenix Viewer ParcelWL [3]

Credits

LightShare was initially created by Meta7.

The Meta7 LightShare feature documentation can be found here:

• https://www.meta7.com/wiki.php?page=LightShare

Default settings are shown being set in this Meta7 sample script:

• https://www.meta7.com/wiki.php?page=Default%20LightShare%20Script

Using this script on OpenSimulator requires manual changing the cmSetWindlightScene function name to lsSetWindlightScene

Additional Note January 2013: The META 7 pages are offline. There is also no Reference or cached pages on the Waybackmachine [4]