llGetTexture

From Second Life Wiki
Revision as of 00:09, 20 April 2008 by Strife Onizuka (talk | contribs) (it always returns a string, even if it represent a key. That caveat you added doesn't make sense, there is no way to determine if a texture is no full rights if it isn't in inventory)
Jump to navigation Jump to search

Summary

Function: string llGetTexture( integer face );
0.0 Forced Delay
10.0 Energy

Returns a string that is the texture on face

• integer face face number or ALL_SIDES

If face is ALL_SIDES then the function works on all sides. If the texture is in the prim's inventory, the return value is the inventory name, otherwise the returned value is the texture UUID.

Caveats

  • The function silently fails if its face value indicates a face that does not exist.
  • If the host object is no-mod and the texture is not in the prim's inventory, the returned value is NULL_KEY.
  • The white texture from the texture picker is "5748decc-f629-461c-9a36-a35a221fe21f"
  • The default texture (plywood) is "89556747-24cb-43ed-920b-47caed15465f"

Examples

<lsl> //Tells (on chat) the texture keys / texture names on 6 sides default {

   state_entry()
   {
       integer i = 0;
       integer max = llGetNumberOfSides();
       while(i < max)
       {
           llSay(0,"Side " + (string)i + " texture is: " + (string)llGetTexture(i));
           ++i;
       }
   }

}

</lsl>

See Also

Functions

•  llSetTexture
•  llSetLinkTexture Sets link's texture
•  llGetNumberOfSides Gets the number of faces on the prim

Deep Notes

History

Signature

function string llGetTexture( integer face );