OsSetDynamicTextureURL

From OpenSimulator

(Difference between revisions)
Jump to: navigation, search
m
m (Fix script)
 
(14 intermediate revisions by 4 users not shown)
Line 1: Line 1:
 
{{osslfunc
 
{{osslfunc
−
|threat_level=VeryLow
+
|threat_level=VeryHigh
 +
|permissions=ESTATE_MANAGER,ESTATE_OWNER
 +
|delay=0
 
|function_syntax=string osSetDynamicTextureURL(string dynamicID, string contentType, string url, string extraParams, integer timer)
 
|function_syntax=string osSetDynamicTextureURL(string dynamicID, string contentType, string url, string extraParams, integer timer)
−
|csharp_syntax=string osSetDynamicTextureURL(string dynamicID, string contentType, string url, string extraParams, int timer)
 
 
|ossl_example=<source lang="lsl">
 
|ossl_example=<source lang="lsl">
−
default {
+
default
 +
{
 
     state_entry()
 
     state_entry()
 
     {
 
     {
−
         llSay( 0, "osSetDynamicTextureURL Tester");
+
         llSay(PUBLIC_CHANNEL, "osSetDynamicTextureURL Tester");
 
     }
 
     }
−
     touch_start(integer total_number)
+
 
 +
     touch_start(integer number)
 
     {
 
     {
−
      llSay( 0, "Testing.");
+
        llSay(PUBLIC_CHANNEL, "Testing ...");
−
      string  dynamicID="";
+
        string  dynamicID = "";
−
      integer refreshRate = 600;
+
        integer refreshRate = 600;
−
      string  contentType="image";
+
        string  contentType = "image";
−
      string srcURL1 = "http://www.goes.noaa.gov/FULLDISK/GEVS.JPG"; // Earth
+
        string srcURL = "http://www.goes.noaa.gov/FULLDISK/GEVS.JPG"; // Earth
−
      string srcURL2 = "http://www.srh.noaa.gov/data/satellite/thumbs/ECI8.JPG"; // US Weather
+
        string URLTexture = osSetDynamicTextureURL(dynamicID, contentType, srcURL, "", refreshRate);
−
      string srcURL = "http://ichart.finance.yahoo.com/b?s=%5EGSPC"; // Stock market
+
 
−
      string URLTexture=osSetDynamicTextureURL(dynamicID, contentType ,srcURL , "", refreshRate );  
+
        if (llStringLength(URLTexture) > 0)  
−
      if (llStringLength(URLTexture)>0)  
+
        {
−
      {
+
            llSay(PUBLIC_CHANNEL, "URLTexture = " + URLTexture);
−
        llSay(0,"URLTexture = "+URLTexture);
+
            llSetTexture(URLTexture, ALL_SIDES);
−
        llSetTexture(URLTexture, ALL_SIDES);
+
        }
−
      }
+
    }
−
  }
+
 
}
 
}
 
</source>
 
</source>
Line 32: Line 34:
 
}}
 
}}
  
−
{| width="100%" style="border: thin solid black"
+
{| width="100%" style="border: thin solid black"
−
| colspan="3" align="center" style=background:orange | Parameters
+
| colspan="3" align="center" style=background:orange | '''Parameters'''
 
|-
 
|-
−
| '''Name'''  
+
|'''Name'''
−
| '''Description'''  
+
|'''Description'''
−
| '''Remarks'''
+
|'''Remarks'''
 
|-
 
|-
−
| '''dynamicID'''  
+
|style = style="vertical-align: top;" |'''dynamicID'''
−
| UUID of already existing dynamic texture. Intended to accept UUID from a previous call to OsSetDynamicTextureXXXX functions in order to provide modification of an existing dynamic texture  
+
|style = style="vertical-align: top;" |UUID of already existing dynamic texture. Intended to accept UUID from a previous call to OsSetDynamicTextureXXXX functions in order to provide modification of an existing dynamic texture
−
| NOT IMPLEMENTED YET
+
|style = style="vertical-align: top;" |NOT IMPLEMENTED
 
|-
 
|-
−
| '''contentType'''  
+
|style = style="vertical-align: top;" |'''contentType'''  
−
| specifies the type of the '''data''' parameter.  
+
|style = style="vertical-align: top;" |specifies the type of the '''data''' parameter.  
−
The following values are allowed:  
+
The following values are allowed:
−
 
+
* image
−
*image - the '''data''' parameter contains an URL.
+
|
−
 
+
−
|  
+
 
|-
 
|-
−
| '''url'''  
+
|style = style="vertical-align: top;" |'''url'''
−
| The URL of any image (including php scripts) that OpenSimulator can render.
+
|style = style="vertical-align: top;" | the url of the source image to use
−
|  
+
|
 
|-
 
|-
−
| '''extraParams'''  
+
|style = style="vertical-align: top;" |'''extraParams'''
−
| additional optional parameters in the following format: [param]:[value],[param]:[value]  
+
|style = style="vertical-align: top;" |additional optional parameters in the following format: [param]:[value],[param]:[value]
−
Multiple parameters are separated by commas. The following ones are supported for [[OsSetDynamicTextureData|osSetDynamicTextureData]] and may also work here (can anyone confirm this?):  
+
Multiple parameters are separated by commas. The following ones are supported:
−
 
+
* width - width of the dynamic texture in pixels (example: width:256)
−
*width - width of the dynamic texture in pixels (example: width:256)  
+
* height - height of the dynamic texture in pixels (example: height:256)
−
*height - height of the dynamic texture in pixels (example: height:256)  
+
* alpha - alpha (transparency) component of the dynamic texture. Values are from 0-clear to 255-solid (example: alpha:255)
−
*alpha - alpha (transparency) component of the dynamic texture. Values are from 0-clear to 255-solid, and ''false'' to turn off the alpha layer completely (example: alpha:255)  
+
* bgcolor - specifies the background color of the texture (example:   bgcolor:Red)
−
*bgcolour - specifies the background color of the texture (example: bgcolour:Red)  
+
* altdatadelim - specifies a delimiter between the draw commands contained in the '''data''' parameter.
−
*setalpha
+
* setalpha - integer value is treated like specifying alpha component
−
*integer value - any integer value is treated like specifing alpha component
+
* lossless - true or false, default false
−
 
+
|
−
|  
+
 
|-
 
|-
−
| '''timer'''  
+
|style = style="vertical-align: top;" |'''timer'''
−
| specify a time interval to update the texture  
+
|style = style="vertical-align: top;" |specify a time interval to update the texture
−
| NOT IMPLEMENTED YET
+
|style = style="vertical-align: top;" |NOT IMPLEMENTED
 
|}
 
|}
  
Line 77: Line 76:
 
The '''dynamicID''' parameter is not implemented. The value passed will be ignored.  
 
The '''dynamicID''' parameter is not implemented. The value passed will be ignored.  
  
−
The '''timer''' parameter is not implemented. The value passed will be ignored. Instead, you can use a timer event and recall the function to get the same effect.  
+
The '''timer''' parameter is not implemented. The value passed will be ignored. Instead, you can use a timer event and recall the function to get the same effect.
 +
 
 +
'''lossless''' parameter added on version 0.9.1.1, Nov 4th 2019. Old versions did as true, but that should one be used if needed<br>
  
−
*See also the script [[OsSetDynamictextureURL example2|osWeatherMap.lsl]] from the standard OpenSimulator Library.
 
  
 +
* See also the script [[OsSetDynamictextureURL example2|osWeatherMap.lsl]] from the standard OpenSimulator Library.
  
−
[[Category:OSSL_pages_in_need_of_parameters_template]]
+
[[Category:OSSL pages in need of parameters template]]

Latest revision as of 13:47, 21 October 2020

Languages Languages: 

En.png English

string osSetDynamicTextureURL(string dynamicID, string contentType, string url, string extraParams, integer timer)
  • Renders a web texture on the prim containing the script and returns the UUID of the newly created texture.
  • If you use this feature, you have to turn on any cache. If not, you'll see complete white texture. Flotsam cache performs better than cenome cache(default).
Threat Level VeryHigh
Permissions ESTATE_MANAGER,ESTATE_OWNER
Extra Delay 0 seconds
Example(s) 
default
{
    state_entry()
    {
        llSay(PUBLIC_CHANNEL, "osSetDynamicTextureURL Tester");
    }
 
    touch_start(integer number)
    {
        llSay(PUBLIC_CHANNEL, "Testing ...");
        string  dynamicID = "";
        integer refreshRate = 600;
        string  contentType = "image";
        string srcURL = "http://www.goes.noaa.gov/FULLDISK/GEVS.JPG"; // Earth
        string URLTexture = osSetDynamicTextureURL(dynamicID, contentType, srcURL, "", refreshRate);
 
        if (llStringLength(URLTexture) > 0) 
        {
            llSay(PUBLIC_CHANNEL, "URLTexture = " + URLTexture);
            llSetTexture(URLTexture, ALL_SIDES);
        }
    }
}


Parameters
Name Description Remarks
dynamicID UUID of already existing dynamic texture. Intended to accept UUID from a previous call to OsSetDynamicTextureXXXX functions in order to provide modification of an existing dynamic texture NOT IMPLEMENTED
contentType specifies the type of the data parameter.

The following values are allowed:

  • image
url the url of the source image to use
extraParams additional optional parameters in the following format: [param]:[value],[param]:[value]

Multiple parameters are separated by commas. The following ones are supported:

  • width - width of the dynamic texture in pixels (example: width:256)
  • height - height of the dynamic texture in pixels (example: height:256)
  • alpha - alpha (transparency) component of the dynamic texture. Values are from 0-clear to 255-solid (example: alpha:255)
  • bgcolor - specifies the background color of the texture (example: bgcolor:Red)
  • altdatadelim - specifies a delimiter between the draw commands contained in the data parameter.
  • setalpha - integer value is treated like specifying alpha component
  • lossless - true or false, default false
timer specify a time interval to update the texture NOT IMPLEMENTED

Notes

The dynamicID parameter is not implemented. The value passed will be ignored.

The timer parameter is not implemented. The value passed will be ignored. Instead, you can use a timer event and recall the function to get the same effect.

lossless parameter added on version 0.9.1.1, Nov 4th 2019. Old versions did as true, but that should one be used if needed


Retrieved from "http://opensimulator.org/index.php?title=OsSetDynamicTextureURL&oldid=49663"
Personal tools
General
About This Wiki