Difference between revisions of "LlGetTexture"
Jump to navigation
Jump to search
All Issues ~ Search JIRA for related Bugs
Anylyn Hax (talk | contribs) m (a small test) |
m (<lsl> tag to <source>) |
||
| (13 intermediate revisions by 6 users not shown) | |||
| Line 1: | Line 1: | ||
{{LSL_Function | {{LSL_Function | ||
|inject-2={{LSL Function/face|face|ALL_SIDES=returns the value for face zero.|return=[[NULL_KEY]]}} | |||
|func_id=57|func_sleep=0.0|func_energy=10.0 | |func_id=57|func_sleep=0.0|func_energy=10.0 | ||
|func=llGetTexture|return_type=string | |func=llGetTexture|return_type=string|p1_type=integer|p1_name=face | ||
|return_text=that is the texture on '''face''' | |return_text=that is the texture on '''face''' | ||
|func_footnote=If the texture is in the prim's inventory, the return value is the inventory name, otherwise the | |func_footnote=If the texture is in the prim's inventory, the return value is the inventory name, otherwise the returned value is the texture [[UUID]]. | ||
|spec | |spec | ||
|caveats=* | |caveats=*{{LSL Constant/NULL KEY}} is returned when the {{LSLGC|Owner|owner}} does not have {{LSLGC|Permissions/Asset|full permissions}} to the object and the texture is not in the prim's inventory. | ||
*The white texture from the texture picker is "[[TEXTURE_BLANK|5748decc-f629-461c-9a36-a35a221fe21f]]" | |||
*The | *The default texture (plywood) is "[[TEXTURE_PLYWOOD|89556747-24cb-43ed-920b-47caed15465f]]" | ||
*The | |||
|constants | |constants | ||
|examples=< | |examples=<source lang="lsl2"> | ||
//Tells (on chat) the texture keys / texture names on 6 sides | //Tells (on chat) the texture keys / texture names on 6 sides | ||
default | default | ||
| Line 27: | Line 25: | ||
} | } | ||
} | } | ||
</ | </source> | ||
|helpers | |helpers | ||
|also_functions={{LSL DefineRow||[[llSetTexture]]|}} | |also_functions={{LSL DefineRow||{{LSLGC|PrimitiveParams}}|[[PRIM_TEXTURE]]}} | ||
{{LSL DefineRow||[[llSetTexture]]|}} | |||
{{LSL DefineRow||[[llSetLinkTexture]]|Sets link's texture}} | {{LSL DefineRow||[[llSetLinkTexture]]|Sets link's texture}} | ||
{{LSL DefineRow||[[llGetNumberOfSides]]|Gets the number of faces on the prim}} | {{LSL DefineRow||[[llGetNumberOfSides]]|Gets the number of faces on the prim}} | ||
| Line 38: | Line 37: | ||
|history= | |history= | ||
*On 5/15/2005 (give or take a day) llGetTexture was changed to check the host object's permissions and if inadequate return {{LSL Constant/NULL_KEY}}. | *On 5/15/2005 (give or take a day) llGetTexture was changed to check the host object's permissions and if inadequate return {{LSL Constant/NULL_KEY}}. | ||
**http://forums.secondlife.com/ | **http://forums-archive.secondlife.com/54/a1/47066/1.html | ||
**http://forums.secondlife.com/ | **http://forums-archive.secondlife.com/54/09/33388/1.html | ||
|cat1 | |cat1 | ||
|cat2=Texture | |cat2=Texture | ||
Revision as of 03:00, 22 January 2015
| LSL Portal | Functions | Events | Types | Operators | Constants | Flow Control | Script Library | Categorized Library | Tutorials |
Summary
Function: string llGetTexture( integer face );| 57 | Function ID |
| 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 returns the value for face zero. 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
- If face indicates a face that does not exist the return is NULL_KEY
- NULL_KEY is returned when the owner does not have full permissions to the object and the texture is not in the prim's inventory.
- The white texture from the texture picker is "5748decc-f629-461c-9a36-a35a221fe21f"
- The default texture (plywood) is "89556747-24cb-43ed-920b-47caed15465f"
Examples
//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;
}
}
}
See Also
Functions
| • | PrimitiveParams | – | PRIM_TEXTURE | |
| • | llSetTexture | |||
| • | llSetLinkTexture | – | Sets link's texture | |
| • | llGetNumberOfSides | – | Gets the number of faces on the prim |
Deep Notes
History
- On 5/15/2005 (give or take a day) llGetTexture was changed to check the host object's permissions and if inadequate return NULL_KEY.
Search JIRA for related Issues
Signature |
|---|
function string llGetTexture( integer face ); |