Difference between revisions of "LlRequestSimulatorData"
Jump to navigation
Jump to search
m |
m |
||
| (4 intermediate revisions by 3 users not shown) | |||
| Line 12: | Line 12: | ||
|spec | |spec | ||
|caveats= | |caveats= | ||
*There is no | *There is no DATA_SIM_MAXPRIMS flag (but <code>[[llGetEnv]]("region_product_name")</code> returns the region type). [[#SVC-4921|SVC-4921]] | ||
|constants={{{!}} {{Prettytable|style=margin-top:0;}} | |constants={{{!}} {{Prettytable|style=margin-top:0;}} | ||
{{!}}- {{Hl2}} | {{!}}- {{Hl2}} | ||
| Line 22: | Line 22: | ||
{{!}}} | {{!}}} | ||
|examples=Hide objects in PG or unknown regions | |examples=Hide objects in PG or unknown regions | ||
< | <source lang="lsl2"> | ||
key gRateingQuery = NULL_KEY ; | key gRateingQuery = NULL_KEY ; | ||
| Line 63: | Line 63: | ||
}//default | }//default | ||
</ | </source> | ||
|helpers | |helpers | ||
|also_functions= | |also_functions= | ||
{{LSL DefineRow||[[llGetEnv]]|}} | |||
{{LSL DefineRow||[[llGetParcelDetails]]|}} | {{LSL DefineRow||[[llGetParcelDetails]]|}} | ||
{{LSL DefineRow||[[llGetParcelFlags]]|}} | {{LSL DefineRow||[[llGetParcelFlags]]|}} | ||
| Line 74: | Line 75: | ||
|also_events | |also_events | ||
|also_articles | |also_articles | ||
|notes | |notes=Global Position in meters | ||
|issues | |issues | ||
|cat1=Dataserver | |cat1=Dataserver | ||
Latest revision as of 07:30, 1 November 2016
| 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
Examples
Hide objects in PG or unknown regions
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" || data == "ADULT") show();
else if (data == "UNKNOWN" || data == "PG") hide();
}//gRateingQuery
}//dataserver
}//default
Notes
Global Position in meters
See Also
Functions
| • | llGetEnv | |||
| • | 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 ); |