Difference between revisions of "LlOffsetTexture"

From Second Life Wiki
Jump to navigation Jump to search
 
m (<lsl> tag to <source>)
 
(13 intermediate revisions by 5 users not shown)
Line 1: Line 1:
{{LSLFunctionAll|func_id=56|func_sleep=0.2|func_energy=10.0|func=llOffsetTexture|p1_type=float|p1_name=rotation|p2_type=integer|p2_name=face|func_footnote=sets the texture rotation for the chosen face|return_text|spec|caveats|examples|helpers|related|also|notes}}[[Category:LSL_Functions]][[Category:LSL_Stub]]
{{LSL_Function
|inject-2={{LSL Function/face|face}}
|func_id=55|func_sleep=0.2|func_energy=10.0
|func=llOffsetTexture
|p1_type=float|p1_name=u|p1_desc=horizontal (x) offset in the interval {{Interval|lte=1.0|gte=-1.0|center=u}}|p1_hover=horizontal (x) offset in the interval {{Interval/Text|lte=1.0|gte=-1.0|center=u}}
|p2_type=float|p2_name=v|p2_desc=vertical (y) offset in the interval {{Interval|lte=1.0|gte=-1.0|center=v}}|p2_hover=vertical (y) offset in the interval {{Interval/Text|lte=1.0|gte=-1.0|center=v}}
|p3_type=integer|p3_name=face
|func_desc=Sets the texture {{LSLP|u}} & {{LSLP|v}} offsets for the chosen {{LSLP|face}}.
|return_text
|spec
|caveats
|constants
|examples=<source lang="lsl2">
//Offsets the textures on 6 sides
float offset;
default
{
    state_entry()
    {
        integer i;
       
        for( i = 1; i < 7; i++ )
        {
            offset = offset + .1;
            llOffsetTexture( (float)offset, (float)offset, i);
        }
    }
}
</source>
|helpers
|also_functions={{LSL DefineRow||[[llGetTextureOffset]]|Returns a vector in the form {{LSL VR|u|v|0.0}}}}
|also_tests
|also_events
|also_articles
|notes=If you use <code>vector offsetVec = [[llGetTextureOffset]]()</code> to get the vector of the current offset, then <code>u = offsetVec.x</code> and <code>v = offsetVec.y</code>
|cat1=Face
|cat2=Texture
|cat3
|cat4
}}

Latest revision as of 14:03, 22 January 2015

Summary

Function: llOffsetTexture( float u, float v, integer face );

Sets the texture u & v offsets for the chosen face.

• float u horizontal (x) offset in the interval [-1.0, 1.0]
• float v vertical (y) offset in the interval [-1.0, 1.0]
• integer face face number or ALL_SIDES

If face is ALL_SIDES then the function works on all sides.

Caveats

  • This function causes the script to sleep for 0.2 seconds.
  • The function silently fails if its face value indicates a face that does not exist.
All Issues ~ Search JIRA for related Bugs

Examples

//Offsets the textures on 6 sides
float offset;
default
{
    state_entry()
    {
        integer i;
        
        for( i = 1; i < 7; i++ )
        {
            offset = offset + .1;
            llOffsetTexture( (float)offset, (float)offset, i);
        }
    }
}

Notes

If you use vector offsetVec = llGetTextureOffset() to get the vector of the current offset, then u = offsetVec.x and v = offsetVec.y

See Also

Functions

•  llGetTextureOffset Returns a vector in the form <u, v, 0.0>

Deep Notes

Search JIRA for related Issues

Footnotes

  1. ^ The ranges in this article are written in Interval Notation.

Signature

function void llOffsetTexture( float u, float v, integer face );