Difference between revisions of "LlGetTexture"
Jump to navigation
Jump to search
(I don't think "or" is correct. If it were then this function would only return inventory names and never uuids.) |
(Add Blinn-Phong terminology to page following PBR release.) |
||
| (4 intermediate revisions by 3 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.}} | |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|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 | ||
| Line 10: | Line 10: | ||
*The default texture (plywood) is "[[TEXTURE_PLYWOOD|89556747-24cb-43ed-920b-47caed15465f]]" | *The default texture (plywood) is "[[TEXTURE_PLYWOOD|89556747-24cb-43ed-920b-47caed15465f]]" | ||
|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 25: | Line 25: | ||
} | } | ||
} | } | ||
</ | </source> | ||
|helpers | |helpers | ||
|also_functions={{LSL DefineRow||{{LSLGC|PrimitiveParams}}|[[PRIM_TEXTURE]]}} | |also_functions={{LSL DefineRow||{{LSLGC|PrimitiveParams}}|[[PRIM_TEXTURE]]}} | ||
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 ); |