Difference between revisions of "LlRequestSimulatorData"

From Second Life Wiki
Jump to navigation Jump to search
m
m
Line 1: Line 1:
{{Issues/SVC-2596}}{{#vardefine:p_data_desc|DATA_* flag}}{{LSL_Function
{{LSL_Function
|inject-2={{Issues/SVC-2596}}{{Issues/SVC-4921}}
|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
|return_type=key
|return_type=key
|p1_type=string|p1_name=region|p1_desc=Case sensitive region name.
|p1_type=string|p1_name=region|p1_desc=Case sensitive region name.
|p2_type=integer|p2_name=data
|p2_type=integer|p2_name=data|p2_desc=DATA_* flag
|func_footnote
|func_footnote
|func_desc=Requests '''{{LSL Param|data}}''' about '''region'''. When '''{{LSL Param|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=that is the handle for a {{LSLG|dataserver}} event response.
|return_text=that is the handle for a {{LSLG|dataserver}} event response.
|spec
|spec
|caveats
|caveats=
*There is no DATA_SIM_TYPE or DATA_SIM_MAXPRIMS. [[#SVC-4921|SVC-4921]]
*There is no DATA_SIM_TYPE or DATA_SIM_MAXPRIMS flags. [[#SVC-4921|SVC-4921]]
|constants={{{!}} {{Prettytable|style=margin-top:0;}}
|constants={{{!}} {{Prettytable|style=margin-top:0;}}
{{!}}- {{Hl2}}
{{!}}- {{Hl2}}

Revision as of 10:30, 7 June 2012

Summary

Function: key llRequestSimulatorData( string region, integer data );

Requests data about region. When data is available the dataserver event will be raised.
Returns a key that is the handle 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" Parcel lght G.png General
"MATURE" Parcel lght M.png Moderate
"ADULT" Parcel lght A.png 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
All Issues ~ Search JIRA for related Bugs

Examples

Deep Notes

All Issues

~ Search JIRA for related Issues
   Script dataserver events become permanently blocked until sim restart
   Please add a way to get the region type ("full", "homestead", "openspace") to llRequestSimulatorData

Tests

•  llRequestSimulatorData Test

Signature

function key llRequestSimulatorData( string region, integer data );