OsSetDynamicTextureURL

From OpenSimulator

Jump to: navigation, search
string osSetDynamicTextureURL(string dynamicID, string contentType, string url, string extraParams, integer timer)
C#: string osSetDynamicTextureURL(string dynamicID, string contentType, string url, string extraParams, int 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 VeryLow
Permissions ${XEngine|osslParcelOG}ESTATE_MANAGER,ESTATE_OWNER
Delay 0 seconds
Example(s)
default {
    state_entry()
    {
        llSay( 0, "osSetDynamicTextureURL Tester");
    }
    touch_start(integer total_number)
    {
      llSay( 0, "Testing.");
      string  dynamicID="";
      integer refreshRate = 600;
      string  contentType="image";
      string srcURL1 = "http://www.goes.noaa.gov/FULLDISK/GEVS.JPG"; // Earth
      string srcURL2 = "http://www.srh.noaa.gov/data/satellite/thumbs/ECI8.JPG"; // US Weather
      string srcURL = "http://ichart.finance.yahoo.com/b?s=%5EGSPC"; // Stock market
      string URLTexture=osSetDynamicTextureURL(dynamicID, contentType ,srcURL  , "", refreshRate ); 
      if (llStringLength(URLTexture)>0) 
       {
         llSay(0,"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 YET
contentType specifies the type of the data parameter.

The following values are allowed:

  • image - the data parameter contains an URL.
url The URL of any image (including php scripts) that OpenSimulator can render.
extraParams additional optional parameters in the following format: [param]:[value],[param]:[value]

Multiple parameters are separated by commas. The following ones are supported for osSetDynamicTextureData and may also work here (can anyone confirm this?):

  • 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, and false to turn off the alpha layer completely (example: alpha:255)
  • bgcolour - specifies the background color of the texture (example: bgcolour:Red)
  • setalpha
  • integer value - any integer value is treated like specifing alpha component
timer specify a time interval to update the texture NOT IMPLEMENTED YET

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.

Personal tools
General
About This Wiki