Difference between revisions of "LlGetRegionTimeDilation"

From Second Life Wiki
Jump to navigation Jump to search
m
Line 11: Line 11:
*[[llGetTime]] & [[llGetAndResetTime]]
*[[llGetTime]] & [[llGetAndResetTime]]
*Intervals of [[timer]] & [[sensor]] events queued as a result of [[llSetTimerEvent]] & [[llSensorRepeat]].
*Intervals of [[timer]] & [[sensor]] events queued as a result of [[llSetTimerEvent]] & [[llSensorRepeat]].
|caveats=
|caveats= *Region idling lowers a region's framerate when no avatars are currently on or looking into the region. Scripts measuring time dilation with llGetRegionTimeDilation may report significant time dilation if the region is idle.
|constants
|constants
|examples=<lsl>
|examples=<lsl>

Revision as of 10:14, 15 May 2012

Summary

Function: float llGetRegionTimeDilation( );

Returns a float that is the current time dilation, the value range is [0.0, 1.0], 0.0 (full dilation) and 1.0 (no dilation).[1]

It is used as the ratio between the change of script time to that of real world time.

Specification

Time dilation is a method the server uses to cope with simulator lag. Physics and script generated lag can result in time dilation. Time dilation slows script time & execution. When time dilation is zero script execution halts.

Affects

Caveats

  • Region idling lowers a region's framerate when no avatars are currently on or looking into the region. Scripts measuring time dilation with llGetRegionTimeDilation may report significant time dilation if the region is idle.
All Issues ~ Search JIRA for related Bugs

Examples

<lsl> // The beginnings of a region-info script. string region; string sim;

default {

   state_entry()
   {
       llSetTimerEvent(1.0);
   }
   timer()
   {
       string here = llGetRegionName();
       if(region != here)
       {
           sim = llGetSimulatorHostname();
           region = here;
       }
       llSetText(
               "   REGION NAME : " + region + 
             "\n  SIM HOSTNAME : " + sim + 
             "\n TIME DILATION : " + (string)llGetRegionTimeDilation() +
             "\n    REGION FPS : " + (string)llGetRegionFPS(),
           <0,1,0>, 1.0);
   }

}

</lsl>

See Also

Functions

•  llGetRegionFPS
•  llGetTime
•  llGetAndResetTime

Deep Notes

Search JIRA for related Issues

Footnotes

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

Signature

function float llGetRegionTimeDilation();