Difference between revisions of "LlGetEnv"

From Second Life Wiki
Jump to navigation Jump to search
m
m (weird center alignment *shrug*)
Line 27: Line 27:
{{!}} {{Yes|[[integer]]}}
{{!}} {{Yes|[[integer]]}}
{{!}}-
{{!}}-
{{!}} {{Maybe|"estate_name"}}
{{!}} {{Maybe|"estate_name"|align=left}}
{{!}} "Estate", "Mainland", "Linden Homes", "My Happy Estate", etc.
{{!}} "Estate", "Mainland", "Linden Homes", "My Happy Estate", etc.
{{!}} {{No|N/A}}
{{!}} {{No|N/A}}
Line 35: Line 35:
{{!}} {{Yes|[[integer]]}}
{{!}} {{Yes|[[integer]]}}
{{!}}-
{{!}}-
{{!}} {{Maybe|"region_cpu_ratio"}}
{{!}} {{Maybe|"region_cpu_ratio"|align=left}}
{{!}} Get number of regions per CPU for this region type. Returns 1 or 4.
{{!}} Get number of regions per CPU for this region type. Returns 1 or 4.
{{!}} {{Yes|[[integer]]}}
{{!}} {{Yes|[[integer]]}}
Line 43: Line 43:
{{!}} {{Yes|[[integer]] [http://en.wikipedia.org/wiki/Boolean_algebra_%28logic%29 boolean]}}
{{!}} {{Yes|[[integer]] [http://en.wikipedia.org/wiki/Boolean_algebra_%28logic%29 boolean]}}
{{!}}-
{{!}}-
{{!}} {{Maybe|"region_product_name"}}
{{!}} {{Maybe|"region_product_name"|align=left}}
{{!}} Get the type of region this is: "mainland", "openspace" etc.
{{!}} Get the type of region this is: "mainland", "openspace" etc.
{{!}} {{No|N/A}}
{{!}} {{No|N/A}}
{{!}}-
{{!}}-
{{!}} {{Maybe|"region_product_sku"}}
{{!}} {{Maybe|"region_product_sku"|align=left}}
{{!}} Get the region's product number (as string).
{{!}} Get the region's product number (as string).
{{!}} {{No|N/A}}
{{!}} {{No|N/A}}
{{!}}-
{{!}}-
{{!}} {{Maybe|"region_start_time"}}
{{!}} {{Maybe|"region_start_time"|align=left}}
{{!}} Get the time the region was last (re)started
{{!}} Get the time the region was last (re)started
{{!}} {{No|N/A}}
{{!}} {{No|N/A}}
Line 63: Line 63:
{{!}} {{No|N/A}}
{{!}} {{No|N/A}}
{{!}}-
{{!}}-
{{!}} {{Maybe|"simulator_hostname"}}
{{!}} {{Maybe|"simulator_hostname"|align=left}}
{{!}} Get the simhost running this region. Same as [[llGetSimulatorHostname]] but without the script delay.
{{!}} Get the simhost running this region. Same as [[llGetSimulatorHostname]] but without the script delay.
{{!}} {{No|N/A}}
{{!}} {{No|N/A}}

Revision as of 14:14, 28 April 2015

Summary

Function: string llGetEnv( string name );

Returns a string with the requested data about the region.

• string name The name of the data to request

Note that the value returned is a string, you may need to cast it to an integer for use in calculations.

Entries in yellow on RC channels from 2015-04-29.

Table of valid name values.
Name Description Type to typecast to
"dynamic_pathfinding" Get the region's effective dynamic_pathfinding status, "enabled" or "disabled". This option is configured in the Region Debug Console N/A
"estate_id" Numerical index identifying which estate a region belongs to. Main grid mainland is "1" integer
"estate_name" "Estate", "Mainland", "Linden Homes", "My Happy Estate", etc. N/A
"frame_number" Get the frame number of the simulator, for example "42042". integer
"region_cpu_ratio" Get number of regions per CPU for this region type. Returns 1 or 4. integer
"region_idle" Get the region's idle status, "1" or "0". integer boolean
"region_product_name" Get the type of region this is: "mainland", "openspace" etc. N/A
"region_product_sku" Get the region's product number (as string). N/A
"region_start_time" Get the time the region was last (re)started N/A
"sim_channel" Get the region's channel string, for example "Second Life Server". N/A
"sim_version" Get the region's version number string, for example "10.11.30.215699". N/A
"simulator_hostname" Get the simhost running this region. Same as llGetSimulatorHostname but without the script delay. N/A

Examples

default
{
    touch_start(integer total_number)
    {
        string version = llGetEnv("sim_version");
        llOwnerSay("Region " + llGetRegionName() + " is running "
                   + llGetEnv("sim_channel") + " version " + version );

        list ver = llParseString2List(version, ["."], []);

        llOwnerSay("Build: "+llList2String(ver, 3));
        llOwnerSay("Build Date: "+llList2String(ver, 2)+"-"+llList2String(ver, 1)+"-20"+llList2String(ver, 0));
    }
}

Notes

  • 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.

See Also

Deep Notes

History

  • SVC-4874
  • Introduced in Second Life RC LeTigre 10.11.30.215699, deployed on 2010-12-01.
  • Deployed to rest of Agni with Second Life Server 10.11.30.215699, Second Life RC BlueSteel 10.12.06.216207, Second Life RC Magnum 10.11.30.215699
  • "frame_number" option added in Second Life RC BlueSteel 12.01.03.247042
    • Returns an integer that represents the current 'frame' of the simulator. Generally only useful for specific debugging cases.
  • Removed (temporarily?) in Second Life RC BlueSteel 12.01.06.247303

Signature

function string llGetEnv( string name );