OsGetRegionMapTexture

From OpenSimulator

(Difference between revisions)
Jump to: navigation, search
m (Added permissions and delay information)
(Replace script)
 
(5 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 
{{osslfunc
 
{{osslfunc
 
|threat_level=High
 
|threat_level=High
|permissions=${XEngine|osslParcelO}ESTATE_MANAGER,ESTATE_OWNER
+
|permissions=${OSSL|osslParcelO}ESTATE_MANAGER,ESTATE_OWNER
 
|delay=1
 
|delay=1
|function_syntax=key osGetRegionMapTexture(string regionName)
+
|function_syntax=key osGetRegionMapTexture(string regionNameOrID)
 
|ossl_example=<source lang="lsl">
 
|ossl_example=<source lang="lsl">
//Example Usage:
+
//
default {
+
// osGetRegionMapTexture Script Exemple
     state_entry() {
+
// Author: djphil
         key map = osGetRegionMapTexture(llGetRegionName());
+
//
         llSetTexture(map, 0);
+
 
 +
default
 +
{
 +
     state_entry()
 +
    {
 +
         llSay(PUBLIC_CHANNEL, "Touch to see osGetRegionMapTexture usage.");
 +
    }
 +
   
 +
    touch_start(integer number)
 +
    {
 +
        string region = llGetRegionName();
 +
        key texture = osGetRegionMapTexture(region);
 +
 
 +
         llSetTexture(TEXTURE_BLANK, ALL_SIDES);
 +
 
 +
        if (texture != NULL_KEY)
 +
        {
 +
            llSetTexture(texture, ALL_SIDES);
 +
            llSay(PUBLIC_CHANNEL, "Region map texture applied with success ...");
 +
        }
 +
 
 +
        else
 +
        {
 +
            llSay(PUBLIC_CHANNEL, "Region map texture applied without success ...");
 +
        }
 
     }
 
     }
 
}
 
}
 
</source>
 
</source>
|description=This function retrieves the UUID of the texture used to represent the named region on the world map, and returns it. Using this function, you can place the map texture directly onto a prim.  
+
|description=This function retrieves the key of the texture used to represent a region on the world map. regionNameOrID can be the region UUID or its name. If empty string, will return the current region map texture key, but in that case you should use osGetMapTexture().
|
+
 
}}
 
}}

Latest revision as of 17:18, 5 December 2020

key osGetRegionMapTexture(string regionNameOrID)
This function retrieves the key of the texture used to represent a region on the world map. regionNameOrID can be the region UUID or its name. If empty string, will return the current region map texture key, but in that case you should use osGetMapTexture().
Threat Level High
Permissions ${OSSL|osslParcelO}ESTATE_MANAGER,ESTATE_OWNER
Extra Delay 1 seconds
Example(s)
//
// osGetRegionMapTexture Script Exemple
// Author: djphil
//
 
default
{
    state_entry()
    {
        llSay(PUBLIC_CHANNEL, "Touch to see osGetRegionMapTexture usage.");
    }
 
    touch_start(integer number)
    {
        string region = llGetRegionName();
        key texture = osGetRegionMapTexture(region);
 
        llSetTexture(TEXTURE_BLANK, ALL_SIDES);
 
        if (texture != NULL_KEY)
        {
            llSetTexture(texture, ALL_SIDES);
            llSay(PUBLIC_CHANNEL, "Region map texture applied with success ...");
        }
 
        else
        {
            llSay(PUBLIC_CHANNEL, "Region map texture applied without success ...");
        }
    }
}
Personal tools
General
About This Wiki