OsGetRegionStats
From OpenSimulator
(Difference between revisions)
m (Syntax) |
|||
(9 intermediate revisions by 5 users not shown) | |||
Line 1: | Line 1: | ||
− | {{ | + | {{osslfunc |
− | + | |threat_level=Moderate | |
− | | | + | |permissions=${OSSL|osslParcelO}ESTATE_MANAGER,ESTATE_OWNER |
− | | | + | |delay=0 |
− | | | + | |function_syntax=list osGetRegionStats() |
− | + | |ossl_example=<source lang="lsl"> | |
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | | | + | |
− | + | ||
// llGetRegionStats() example script | // llGetRegionStats() example script | ||
// | // | ||
Line 20: | Line 13: | ||
state_entry() | state_entry() | ||
{ | { | ||
− | llSetTimerEvent( 5.0 ); | + | llSetTimerEvent(5.0); |
} | } | ||
Line 26: | Line 19: | ||
{ | { | ||
list Stats = osGetRegionStats(); | list Stats = osGetRegionStats(); | ||
− | string s = "Sim FPS: " + (string) llList2Float( Stats, STATS_SIM_FPS ) + "\n"; | + | string s = "Sim FPS: " + (string)llList2Float( Stats, STATS_SIM_FPS) + "\n"; |
− | s += "Physics FPS: " + (string) llList2Float( Stats, STATS_PHYSICS_FPS ) + "\n"; | + | s += "Physics FPS: " + (string)llList2Float( Stats, STATS_PHYSICS_FPS) + "\n"; |
− | s += "Time Dilation: " + (string) llList2Float( Stats, STATS_TIME_DILATION ) + "\n"; | + | s += "Time Dilation: " + (string)llList2Float( Stats, STATS_TIME_DILATION) + "\n"; |
− | s += "Root Agents: " + (string) llList2Integer( Stats, STATS_ROOT_AGENTS ) + "\n"; | + | s += "Root Agents: " + (string)llList2Integer( Stats, STATS_ROOT_AGENTS) + "\n"; |
− | s += "Child Agents: " + (string) llList2Integer( Stats, STATS_CHILD_AGENTS ) + "\n"; | + | s += "Child Agents: " + (string)llList2Integer( Stats, STATS_CHILD_AGENTS) + "\n"; |
− | s += "Total Prims: " + (string) llList2Integer( Stats, STATS_TOTAL_PRIMS ) + "\n"; | + | s += "Total Prims: " + (string)llList2Integer( Stats, STATS_TOTAL_PRIMS) + "\n"; |
− | s += "Active Scripts: " + (string) llList2Integer( Stats, STATS_ACTIVE_SCRIPTS ) + "\n"; | + | s += "Active Scripts: " + (string)llList2Integer( Stats, STATS_ACTIVE_SCRIPTS) + "\n"; |
− | s += "Script LPS: " + (string) llList2Float( Stats, STATS_SCRIPT_LPS ); | + | s += "Script LPS: " + (string)llList2Float( Stats, STATS_SCRIPT_LPS); |
− | llSetText( s, <0.0,1.0,0.0>, 1.0 ); | + | llSetText(s, <0.0, 1.0, 0.0>, 1.0); |
} | } | ||
}</source> | }</source> | ||
+ | |description=Returns a list of float values representing a number of region statistics (many of the values shown in the "Stats Bar" of LL-based clients). Provides similar functionality to llGetRegionFPS() and llGetRegionTimeDilation(), but returns 21 statistics simultaneously. | ||
+ | The elements in the list may be referred to by the following new LSL constants: | ||
− | | | + | |additional_info=Please note that as of November 2009, some of the elements in the array (to wit, the STATS_*_MS values) do not appear to contain useful information. |
− | + | Notes that "STATS_TOTAL_PRIMS" reports worn prims also. | |
− | + | Code provided by Implementor: Godfrey and Implemented in Git Hash 9d05962029fe864408d287d5fa7ef81f312e098a, - Rev 11601 | |
+ | | | ||
+ | }} | ||
− | {| style="white-space:nowrap | + | {| style="white-space:nowrap;border:1px solid #ccc; width:100%;" cellspacing="2" border="1" |
|STATS_TIME_DILATION | |STATS_TIME_DILATION | ||
|0 | |0 | ||
Line 102: | Line 99: | ||
|} | |} | ||
− | + | [[Category:OSSL pages in need of parameters template]] | |
− | + | ||
− | + | ||
− | + | ||
− | [[Category:OSSL | + |
Revision as of 15:25, 27 January 2020
list osGetRegionStats()
| |
Returns a list of float values representing a number of region statistics (many of the values shown in the "Stats Bar" of LL-based clients). Provides similar functionality to llGetRegionFPS() and llGetRegionTimeDilation(), but returns 21 statistics simultaneously.
The elements in the list may be referred to by the following new LSL constants: | |
Threat Level | Moderate |
Permissions | ${OSSL|osslParcelO}ESTATE_MANAGER,ESTATE_OWNER |
Extra Delay | 0 seconds |
Example(s) | |
// llGetRegionStats() example script // // Displays certain region statistics in hovertext above the prim containing the script. // default { state_entry() { llSetTimerEvent(5.0); } timer() { list Stats = osGetRegionStats(); string s = "Sim FPS: " + (string)llList2Float( Stats, STATS_SIM_FPS) + "\n"; s += "Physics FPS: " + (string)llList2Float( Stats, STATS_PHYSICS_FPS) + "\n"; s += "Time Dilation: " + (string)llList2Float( Stats, STATS_TIME_DILATION) + "\n"; s += "Root Agents: " + (string)llList2Integer( Stats, STATS_ROOT_AGENTS) + "\n"; s += "Child Agents: " + (string)llList2Integer( Stats, STATS_CHILD_AGENTS) + "\n"; s += "Total Prims: " + (string)llList2Integer( Stats, STATS_TOTAL_PRIMS) + "\n"; s += "Active Scripts: " + (string)llList2Integer( Stats, STATS_ACTIVE_SCRIPTS) + "\n"; s += "Script LPS: " + (string)llList2Float( Stats, STATS_SCRIPT_LPS); llSetText(s, <0.0, 1.0, 0.0>, 1.0); } } | |
Notes | |
Please note that as of November 2009, some of the elements in the array (to wit, the STATS_*_MS values) do not appear to contain useful information.
Notes that "STATS_TOTAL_PRIMS" reports worn prims also. Code provided by Implementor: Godfrey and Implemented in Git Hash 9d05962029fe864408d287d5fa7ef81f312e098a, - Rev 11601 |
STATS_TIME_DILATION | 0 | STATS_IMAGE_MS | 11 |
STATS_SIM_FPS | 1 | STATS_OTHER_MS | 12 |
STATS_PHYSICS_FPS | 2 | STATS_IN_PACKETS_PER_SECOND | 13 |
STATS_AGENT_UPDATES | 3 | STATS_OUT_PACKETS_PER_SECOND | 14 |
STATS_ROOT_AGENTS | 4 | STATS_UNACKED_BYTES | 15 |
STATS_CHILD_AGENTS | 5 | STATS_AGENT_MS | 16 |
STATS_TOTAL_PRIMS | 6 | STATS_PENDING_DOWNLOADS | 17 |
STATS_ACTIVE_PRIMS | 7 | STATS_PENDING_UPLOADS | 18 |
STATS_FRAME_MS | 8 | STATS_ACTIVE_SCRIPTS | 19 |
STATS_NET_MS | 9 | STATS_SCRIPT_LPS | 20 |
STATS_PHYSICS_MS | 10 |