llRequestSimulatorData

Template:Needs Translation/LSL/de Template:Needs Translation/LSL/es Template:Needs Translation/LSL/el Template:Needs Translation/LSL/he Template:Needs Translation/LSL/it Template:Needs Translation/LSL/ko Template:Needs Translation/LSL/nl Template:Needs Translation/LSL/hu Template:Needs Translation/LSL/no Template:Needs Translation/LSL/da Template:Needs Translation/LSL/sv Template:Needs Translation/LSL/tr Template:Needs Translation/LSL/pl Template:Needs Translation/LSL/pt Template:Needs Translation/LSL/ru Template:Needs Translation/LSL/th Template:Needs Translation/LSL/uk Template:Needs Translation/LSL/zh-Hans Template:Needs Translation/LSL/zh-Hant

/LSL

RequestSimulatorData

llRequestSimulatorData

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_MAXPRIMS flag (but llGetEnv("region_product_name") returns the region type). SVC-4921

All Issues ~ Search JIRA for related Bugs

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 );