OsSetDynamicTextureURLBlendFace
From OpenSimulator
(Difference between revisions)
(5 intermediate revisions by one user not shown) | |||
Line 52: | Line 52: | ||
|'''Remarks''' | |'''Remarks''' | ||
|- | |- | ||
− | |'''dynamicID''' | + | |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 dynasmic texture | + | |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 dynasmic texture |
− | | NOT IMPLEMENTED | + | |style="vertical-align: top;" |NOT IMPLEMENTED |
|- | |- | ||
− | |'''contentType''' | + | |style="vertical-align: top;" |'''contentType''' |
− | |specifies the type of the '''data''' parameter. | + | |style="vertical-align: top;" |specifies the type of the '''data''' parameter. |
The following values are allowed: | The following values are allowed: | ||
* image | * image | ||
| | | | ||
|- | |- | ||
− | |'''url'' | + | |style="vertical-align: top;" |'''url''' |
− | |the url of source image | + | |style="vertical-align: top;" |the url of source image |
| | | | ||
|- | |- | ||
− | |'''extraParams''' | + | |style="vertical-align: top;" |'''extraParams''' |
− | |additional optional parameters in the following format: [param]:[value],[param]:[value] | + | |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: | 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) | ||
Line 79: | Line 79: | ||
| | | | ||
|- | |- | ||
− | |'''blend''' | + | |style="vertical-align: top;" |'''blend''' |
− | |If ''true'', the newly generated texture is blended with the appropriate existing ones on the prim. | + | |style="vertical-align: top;" |If ''true'', the newly generated texture is blended with the appropriate existing ones on the prim. |
| | | | ||
|- | |- | ||
− | |'''disp''' | + | |style="vertical-align: top;" |'''disp''' |
− | |Display flags. Value 1-expire deletes the old texture if it is replaced by a newer generated texture (may not currently be implemented). Value 2-temp flags the asset as temporary, which often means that it is not persisted to the database. | + | |style="vertical-align: top;" |Display flags. Value 1-expire deletes the old texture if it is replaced by a newer generated texture (may not currently be implemented). Value 2-temp flags the asset as temporary, which often means that it is not persisted to the database. |
| | | | ||
|- | |- | ||
− | |'''timer''' | + | |style="vertical-align: top;" |'''timer''' |
− | |specify a time interval to update the texture | + | |style="vertical-align: top;" |specify a time interval to update the texture |
− | |NOT IMPLEMENTED | + | |style="vertical-align: top;" |NOT IMPLEMENTED |
|- | |- | ||
− | |'''alpha''' | + | |style="vertical-align: top;" |'''alpha''' |
− | |The alpha value of the generated texture. 0 (full transparent) to 255 (solid) | + | |style="vertical-align: top;" |The alpha value of the generated texture. 0 (full transparent) to 255 (solid) |
| | | | ||
|- | |- | ||
− | |'''face''' | + | |style="vertical-align: top;" |'''face''' |
− | |The face of the prim on which to put the generated texture. If ALL_SIDES then all sides of the prim are set. | + | |style="vertical-align: top;" |The face of the prim on which to put the generated texture. If ALL_SIDES then all sides of the prim are set. |
| | | | ||
|} | |} | ||
+ | |||
+ | '''Notes:'''<br> | ||
+ | '''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> |
Latest revision as of 06:13, 7 November 2019
string osSetDynamicTextureURLBlendFace(string dynamicID, string contentType, string url, string extraParams, integer blend, integer disp, integer timer, integer alpha, integer face)
| |
No descriptions provided | |
Threat Level | VeryHigh |
Permissions | ESTATE_MANAGER,ESTATE_OWNER |
Extra Delay | 0 seconds |
Example(s) | |
// ---------------------------------------------------------------- // // Example of osSetDynamicTextureURLBlendFace // // ExtraParams Values: // 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- full to 255 - solid // bgcolour - specifies the background color of the texture (example: bgcolour:Red) // setalpha // integer value - any integer value is treated like specifing alpha component default { state_entry() { llSay(0,"Touch to see osSetDynamicTextureURLBlendFace used to render Web Based Image/Texture on a prim"); } touch_start(integer total_num) { string sDynamicID = ""; // not implemented yet string sContentType = "image"; // vector = text/lines,etc. image = texture only string sURL = "http://www.goes.noaa.gov/FULLDISK/GMVS.JPG"; // URL for WebImage (Earth Shown) string sExtraParams = "width:512,height:512"; // optional parameters in the following format: [param]:[value],[param]:[value] integer iBlend = TRUE; // TRUE = the newly generated texture is iBlended with the appropriate existing ones on the prim integer iDisp = 2; // 1 = expire deletes the old texture. 2 = temp means that it is not saved to the Database. integer iTimer = 0; // timer is not implemented yet, leave @ 0 integer iAlpha = 255; // 0 = 100% Transparent 255 = 100% Solid integer iFace = 0; // Faces of the prim, Select the Face you want // Set the prepared texture to the Prim osSetDynamicTextureURLBlendFace( sDynamicID, sContentType, sURL, sExtraParams, iBlend, iDisp, iTimer, iAlpha, iFace ); } } |
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 dynasmic texture | NOT IMPLEMENTED |
contentType | specifies the type of the data parameter.
The following values are allowed:
|
|
url | the url of source image | |
extraParams | additional optional parameters in the following format: [param]:[value],[param]:[value]
Multiple parameters are separated by commas. The following ones are supported:
|
|
blend | If true, the newly generated texture is blended with the appropriate existing ones on the prim. | |
disp | Display flags. Value 1-expire deletes the old texture if it is replaced by a newer generated texture (may not currently be implemented). Value 2-temp flags the asset as temporary, which often means that it is not persisted to the database. | |
timer | specify a time interval to update the texture | NOT IMPLEMENTED |
alpha | The alpha value of the generated texture. 0 (full transparent) to 255 (solid) | |
face | The face of the prim on which to put the generated texture. If ALL_SIDES then all sides of the prim are set. |
Notes:
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