Difference between revisions of "LlRequestSimulatorData"
Jump to navigation
Jump to search
All Issues ~ Search JIRA for related Bugs
m |
m |
||
| Line 1: | Line 1: | ||
{{LSL_Function | {{LSL_Function | ||
|inject-2={{Issues/SVC-2596}}{{Issues/SVC-4921}} | |inject-2={{Issues/SVC-2596}}{{Issues/SVC-4921}}{{Issues/BUG-5031}} | ||
|func_id=293|func_sleep=1.0|func_energy=10.0 | |func_id=293|func_sleep=1.0|func_energy=10.0 | ||
|func=llRequestSimulatorData | |func=llRequestSimulatorData | ||
| Line 9: | Line 9: | ||
|func_footnote | |func_footnote | ||
|func_desc=Requests {{LSLP|data}} about {{LSLP|region}}. When {{LSLP|data}} is available the {{LSLG|dataserver}} event will be raised. | |func_desc=Requests {{LSLP|data}} about {{LSLP|region}}. When {{LSLP|data}} is available the {{LSLG|dataserver}} event will be raised. | ||
|return_text= | |return_text=for a {{LSLG|dataserver}} event response. | ||
|spec | |spec | ||
|caveats= | |caveats= | ||
Revision as of 15:24, 5 February 2014
| LSL Portal | Functions | Events | Types | Operators | Constants | Flow Control | Script Library | Categorized Library | Tutorials |
Summary
Function: key llRequestSimulatorData( string region, integer data );| 293 | Function ID |
| 1.0 | Forced Delay |
| 10.0 | Energy |
Requests data about region. When data is available the dataserver event will be raised.
Returns a handle (a key) for a dataserver event response.
| • string | region | – | Case sensitive region name. | |
| • integer | data | – | DATA_* flag |
| data Constant | Type | Description | ||||
|---|---|---|---|---|---|---|
| DATA_SIM_POS | 5 | (vector) | The regions global position. | |||
| DATA_SIM_STATUS | 6 | string | Value | Description | ||
| "up" | region currently up and running | |||||
| "down" | region currently down | |||||
| "starting" | region currently starting | |||||
| "stopping" | region currently stopping | |||||
| "crashed" | region has crashed | |||||
| "unknown" | region status unknown or unknown region | |||||
| DATA_SIM_RATING | 7 | string | Value | Maturity rating | ||
| "PG" |  General
| |||||
| "MATURE" |  Moderate
| |||||
| "ADULT" |  Adult
| |||||
| "UNKNOWN" | rating or region unknown | |||||
Caveats
- This function causes the script to sleep for 1.0 seconds.
- There is no DATA_SIM_TYPE or DATA_SIM_MAXPRIMS flags. SVC-4921
Examples
Hide objects in PG or unknown regions <lsl> key gRateingQuery = NULL_KEY ;
show() {
llSetLinkAlpha( LINK_SET, 1.0, ALL_SIDES );
}//show
hide() {
llSetLinkAlpha( LINK_SET, 0.0, ALL_SIDES );
}//hide
default {
on_rez(integer Setting)
{
llResetScript();
}//on_rez
state_entry()
{
gRateingQuery = llRequestSimulatorData( llGetRegionName(), DATA_SIM_RATING );
}//state_entry
changed(integer ItChanged)
{
if (ItChanged & CHANGED_OWNER) llResetScript();
if (ItChanged & CHANGED_REGION) llResetScript();
}//changed
dataserver(key query_id, string data)
{
if (query_id == gRateingQuery)
{
if (data == "MATURE"
See Also
Functions
| • | llGetParcelDetails | |||
| • | llGetParcelFlags | |||
| • | llGetParcelMaxPrims | |||
| • | llGetParcelPrimCount |
Deep Notes
All Issues
~ Search JIRA for related Issues
|
|
SVC-2596 | A | Script dataserver events become permanently blocked until sim restart | |
|
|
SVC-4921 | A | Please add a way to get the region type ("full", "homestead", "openspace") to llRequestSimulatorData | |
|
|
|
BUG-5031 | A | llRequestSimulatorData for DATA_SIM_POS returns same position for multiple regions |
Tests
| • | llRequestSimulatorData Test |
Signature |
|---|
function key llRequestSimulatorData( string region, integer data ); |