Difference between revisions of "LlGetSimStats"
Jump to navigation
Jump to search
Kireji Haiku (talk | contribs) m (added example) |
m (<lsl> tag to <source>) |
||
| (4 intermediate revisions by 3 users not shown) | |||
| Line 12: | Line 12: | ||
|caveats | |caveats | ||
|examples= | |examples= | ||
< | <source lang="lsl2"> | ||
default | default | ||
{ | { | ||
| Line 18: | Line 18: | ||
{ | { | ||
float pct_chars_stepped = llGetSimStats(SIM_STAT_PCT_CHARS_STEPPED); | float pct_chars_stepped = llGetSimStats(SIM_STAT_PCT_CHARS_STEPPED); | ||
llSay( | llSay(0, | ||
"The percentage of pathfinding characters | "The percentage of pathfinding characters updated each frame was " | ||
+ (string)pct_chars_stepped + "averaged over the last minute. The " | + (string)pct_chars_stepped + "averaged over the last minute. The " | ||
+ "value corresponds to the 'Characters Updated' stat in the " | + "value corresponds to the 'Characters Updated' stat in the " | ||
+ "viewer's Statistics Bar. ") | + "viewer's Statistics Bar. "); | ||
} | } | ||
} | } | ||
</ | </source> | ||
|helpers | |helpers | ||
|also_functions={{LSL DefineRow||[[llAbs]]|[[integer]] version of llFabs}} | |also_functions={{LSL DefineRow||[[llAbs]]|[[integer]] version of llFabs}} | ||
| Line 32: | Line 32: | ||
|notes | |notes | ||
|cat1=Region | |cat1=Region | ||
|cat2 | |cat2=Pathfinding | ||
|cat3 | |cat3 | ||
|cat4 | |cat4 | ||
|history = Date of Release [[ Release_Notes/Second_Life_Server/12#12.10.26.266333 | 26/10/2012 ]] | |||
}} | }} | ||
Latest revision as of 01:52, 22 January 2015
| LSL Portal | Functions | Events | Types | Operators | Constants | Flow Control | Script Library | Categorized Library | Tutorials |
Summary
Function: float llGetSimStats( integer stat_type );Returns a float that is the requested statistic.
| • integer | stat_type | – | SIM_STAT_* flag |
| Name | Possible Return | Description | |
|---|---|---|---|
| SIM_STAT_PCT_CHARS_STEPPED | 0 | [0.0, 100.0] | The % of pathfinding characters updated each frame, averaged over the last minute. The value corresponds to the "Characters Updated" stat in the viewer's Statistics Bar. |
| SIM_STAT_PHYSICS_FPS | 1 | [0.0, Inf] | Physics simulation FPS. |
| SIM_STAT_AGENT_UPDATES | 2 | [0.0, Inf] | Agent updates per second. |
| SIM_STAT_FRAME_MS | 3 | [0.0, Inf] | Total frame time. |
| SIM_STAT_NET_MS | 4 | [0.0, Inf] | Time spent in 'network' segment of simulation frame. |
| SIM_STAT_OTHER_MS | 5 | [0.0, Inf] | Main simulation segment of frame, encapsulating task, script and misc. updates. |
| SIM_STAT_PHYSICS_MS | 6 | [0.0, Inf] | Time spent in 'physics' segment of simulation frame. |
| SIM_STAT_AGENT_MS | 7 | [0.0, Inf] | Time spent in 'agent' segment of simulation frame. |
| SIM_STAT_IMAGE_MS | 8 | [0.0, Inf] | Time spent in 'image' segment of simulation frame. |
| SIM_STAT_SCRIPT_MS | 9 | [0.0, Inf] | Time spent in 'script' segment of simulation frame. |
| SIM_STAT_AGENT_COUNT | 10 | [0.0, Inf] | Number of agents in region. |
| SIM_STAT_CHILD_AGENT_COUNT | 11 | [0.0, Inf] | Number of child (neighboring) agents in region. |
| SIM_STAT_ACTIVE_SCRIPT_COUNT | 12 | [0.0, Inf] | Number of active scripts in region. |
| SIM_STAT_PACKETS_IN | 13 | [0.0, Inf] | Average packets in per second. |
| SIM_STAT_PACKETS_OUT | 14 | [0.0, Inf] | Average packets out per second. |
| SIM_STAT_ASSET_DOWNLOADS | 15 | [0.0, Inf] | Pending asset download count. |
| SIM_STAT_ASSET_UPLOADS | 16 | [0.0, Inf] | Pending asset upload count. |
| SIM_STAT_UNACKED_BYTES | 17 | [0.0, Inf] | Total unacknowledged bytes. |
| SIM_STAT_PHYSICS_STEP_MS | 18 | [0.0, Inf] | Average physics step time. |
| SIM_STAT_PHYSICS_SHAPE_MS | 19 | [0.0, Inf] | Average physics 'shape' segment update time. |
| SIM_STAT_PHYSICS_OTHER_MS | 20 | [0.0, Inf] | Average physics 'other' segment update time. |
| SIM_STAT_SCRIPT_EPS | 21 | [0.0, Inf] | Script events per second. |
| SIM_STAT_SPARE_MS | 22 | [0.0, Inf] | Spare time left after frame. |
| SIM_STAT_SLEEP_MS | 23 | [0.0, Inf] | Time spent sleeping. |
| SIM_STAT_IO_PUMP_MS | 24 | [0.0, Inf] | PumpIO time. |
| SIM_STAT_SCRIPT_RUN_PCT | 25 | [0.0, 100.0] | Percent of scripts run during frame. |
| SIM_STAT_AI_MS | 26 | [0.0, Inf] | Time spent on AI step. |
Examples
default
{
touch_start(integer num_detected)
{
float pct_chars_stepped = llGetSimStats(SIM_STAT_PCT_CHARS_STEPPED);
llSay(0,
"The percentage of pathfinding characters updated each frame was "
+ (string)pct_chars_stepped + "averaged over the last minute. The "
+ "value corresponds to the 'Characters Updated' stat in the "
+ "viewer's Statistics Bar. ");
}
}
Deep Notes
History
Date of Release 26/10/2012
Footnotes
- ^ The ranges in this article are written in Interval Notation.
Signature |
|---|
function float llGetSimStats( integer stat_type ); |