OsSetDynamicTextureData

From OpenSimulator

(Difference between revisions)
Jump to: navigation, search
m (Instead of putting into a category, i created an internal link to a non-existant page. DUH!)
Line 1: Line 1:
 
{{Template:Quicklinks}}
 
{{Template:Quicklinks}}
 +
{|  width="100%" style="border: thin solid black"
 +
| colspan="2" align="center" style=background:orange | '''{{SUBPAGENAME}}'''
 +
|- valign="top"
 +
|'''Threat Level''' || VeryLow
  
'''Threat Level:''' VeryLow
+
|- valign="top"
 +
|'''Function Syntax''' || <source lang="lsl">
 +
LSL: string osSetDynamicTextureData( string dynamicID, integer contentType, integer data, string extraParams,integer timer)
 +
C#: string osSetDynamicTextureData( string dynamicID, int contentType, int data, string extraParams, int timer)
 +
</source>
 +
|- valign="top"
 +
|'''Example(s)||<source lang="lsl">
 +
// Example of OsSetDynamicTextureData used to render custom drawings on a prim
 +
default
 +
{
 +
    state_entry()
 +
    {
 +
        string CommandList = ""; // Storage for our drawing commands
  
 +
        CommandList = osSetPenSize( CommandList, 3 );                // Set the pen width to 3 pixels
 +
        CommandList = osSetPenColour( CommandList, "Red" );          // Set the pen color to red
 +
        CommandList = osMovePen( CommandList, 28, 78 );              // Upper left corner at <28,78>
 +
        CommandList = osDrawFilledRectangle( CommandList, 200, 100 ); // 200 pixels by 100 pixels
  
LSL: '''[[string]]  osSetDynamicTextureData( [[string]] dynamicID, [[integer]] contentType, [[integer]] data, [[string]] extraParams,[[integer]] timer)'''<br />
+
        // Now draw the rectangle
C#:  '''[[string]]  osSetDynamicTextureData( [[string]] dynamicID, [[int]] contentType, [[int]] data, [[string]] extraParams, [[int]] timer)'''
+
        osSetDynamicTextureData( "", "vector", CommandList, "width:256,height:256", 0 );
 +
    }
 +
}
 +
</source>
  
===Description===
+
Script [[OsSetDynamicdata example1 | osTextBoard.lsl]] from the standard OpenSimulator Library.
Renders a dynamically created texture on the prim containing the script and returns the UUID of the newly created texture.
+
  
===Parameters===
+
|}
  
{| border="1"
+
 
 +
Renders a dynamically created texture on the prim containing the script and returns the UUID of the newly created texture.
 +
{| style="border: thin solid black"
 +
| colspan="3" align="center" style=background:orange | '''Parameters'''
 +
|-
 
|'''Name'''
 
|'''Name'''
 
|'''Description'''
 
|'''Description'''
Line 48: Line 74:
 
|}
 
|}
  
===Notes===
+
'''Notes:'''
  
The '''dynamicID''' parameter is not implemented. The value passed will be ignored.
+
# The '''dynamicID''' parameter is not yet implemented. The value passed will be ignored.
 
+
# The '''timer''' parameter is not yet 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.
+
 
+
===Examples===
+
<source lang="lsl">
+
// Example of OsSetDynamicTextureData used to render custom drawings on a prim
+
default
+
{
+
    state_entry()
+
    {
+
        string CommandList = ""; // Storage for our drawing commands
+
 
+
        CommandList = osSetPenSize( CommandList, 3 );                // Set the pen width to 3 pixels
+
        CommandList = osSetPenColour( CommandList, "Red" );          // Set the pen color to red
+
        CommandList = osMovePen( CommandList, 28, 78 );              // Upper left corner at <28,78>
+
        CommandList = osDrawFilledRectangle( CommandList, 200, 100 ); // 200 pixels by 100 pixels
+
 
+
        // Now draw the rectangle
+
        osSetDynamicTextureData( "", "vector", CommandList, "width:256,height:256", 0 );
+
    }
+
}
+
</source>
+
 
+
Script [[OsSetDynamicdata example1 | osTextBoard.lsl]] from the standard OpenSimulator Library.
+
 
+
===See Also===
+
  
 +
'''See Also'''
 
*[[osSetDynamicTextureURL]]
 
*[[osSetDynamicTextureURL]]
 
*[[osSetDynamicTextureURLBlend]]
 
*[[osSetDynamicTextureURLBlend]]
Line 83: Line 85:
 
*[[osSetDynamicTextureDataBlend]]
 
*[[osSetDynamicTextureDataBlend]]
 
*[[osSetDynamicTextureDataBlendFace]]
 
*[[osSetDynamicTextureDataBlendFace]]
 +
 +
 +
 
[[Category:OSSL Functions]]
 
[[Category:OSSL Functions]]

Revision as of 16:41, 8 June 2011

OsSetDynamicTextureData
Threat Level VeryLow
Function Syntax
LSL: string osSetDynamicTextureData( string dynamicID, integer contentType, integer data, string extraParams,integer timer)
C#: string osSetDynamicTextureData( string dynamicID, int contentType, int data, string extraParams, int timer)
Example(s)
// Example of OsSetDynamicTextureData used to render custom drawings on a prim
default
{
    state_entry()
    {
        string CommandList = ""; // Storage for our drawing commands
 
        CommandList = osSetPenSize( CommandList, 3 );                 // Set the pen width to 3 pixels
        CommandList = osSetPenColour( CommandList, "Red" );           // Set the pen color to red
        CommandList = osMovePen( CommandList, 28, 78 );               // Upper left corner at <28,78>
        CommandList = osDrawFilledRectangle( CommandList, 200, 100 ); // 200 pixels by 100 pixels
 
        // Now draw the rectangle
        osSetDynamicTextureData( "", "vector", CommandList, "width:256,height:256", 0 );
    }
}

Script osTextBoard.lsl from the standard OpenSimulator Library.


Renders a dynamically created texture on the prim containing the script and returns the UUID of the newly created texture.

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 YET
contentType specifies the type of the data parameter.

The following values are allowed:

  • vector - the data parameter contains a list of drawing instructions. See Drawing commands for details
data Contains a series of drawing instructions. See Drawing commands for details
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, and false to turn off the alpha layer completely (example: alpha:255)
  • 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
  • integer value - any integer value is treated like specifing aplha component
timer specify a time interval to update the texture NOT IMPLEMENTED YET

Notes:

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

See Also

Personal tools
General
About This Wiki