Difference between revisions of "LlGetSimStats"

From Second Life Wiki
Jump to navigation Jump to search
m
m (category)
Line 32: Line 32:
|notes
|notes
|cat1=Region
|cat1=Region
|cat2
|cat2=Pathfinding
|cat3
|cat3
|cat4
|cat4
}}
}}

Revision as of 19:26, 10 March 2013

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

<lsl> 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. ");
   }

}

</lsl>

See Also

Functions

•  llAbs integer version of llFabs

Deep Notes

Footnotes

  1. ^ The ranges in this article are written in Interval Notation.

Signature

function float llGetSimStats( integer stat_type );