Difference between revisions of "LlGetTexture"
Jump to navigation
Jump to search
m (<lsl> tag to <source>) |
(Add Blinn-Phong terminology to page following PBR release.) |
||
| Line 3: | Line 3: | ||
|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|p1_type=integer|p1_name=face | |func=llGetTexture|return_type=string|p1_type=integer|p1_name=face | ||
|return_text=that is the texture on '''face''' | |return_text=that is the [[PBR_Materials#Nomenclature_changes|Blinn-Phong]] diffuse texture on '''face''' | ||
|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]]. | |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 | ||
Latest revision as of 05:14, 30 November 2023
| LSL Portal | Functions | Events | Types | Operators | Constants | Flow Control | Script Library | Categorized Library | Tutorials |
Summary
Function: string llGetTexture( integer face );| 0.0 | Forced Delay |
| 10.0 | Energy |
Returns a string that is the Blinn-Phong diffuse 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.
Signature |
|---|
function string llGetTexture( integer face ); |