Difference between revisions of "LlSetTexture"
Jump to navigation
Jump to search
(Add Blinn-Phong terminology to page following PBR release.) |
|||
| (13 intermediate revisions by 7 users not shown) | |||
| Line 1: | Line 1: | ||
{{LSL_Function | {{LSL_Function | ||
|inject-2={{Issues/SVC-914}}{{LSL_Function/face|face}}{{LSL_Function/inventory|texture|uuid=true|type=texture}} | |||
|func=llSetTexture | |func=llSetTexture | ||
|sort=SetTexture | |sort=SetTexture | ||
| Line 7: | Line 7: | ||
|p2_type=integer|p2_name=face | |p2_type=integer|p2_name=face | ||
|func_footnote | |func_footnote | ||
|func_desc=Sets the | |func_desc=Sets the [[PBR_Materials#Nomenclature_changes|Blinn-Phong]] diffuse {{LSLP|texture}} of this prim's {{LSLP|face}}. | ||
|return_text | |return_text | ||
|spec | |spec | ||
|caveats | |caveats= | ||
*[[Inspect]] does not show texture information (like [[llGetInventoryCreator|creator]]) | |||
|constants | |constants | ||
|examples | |examples=<source lang="lsl2"> | ||
default | |||
{ | |||
state_entry() | |||
{ | |||
// the first texture alphabetically inside the same prim's inventory | |||
string texture = llGetInventoryName(INVENTORY_TEXTURE, 0); | |||
// set it on all sides of the prim containing the script | |||
llSetTexture(texture, ALL_SIDES); | |||
} | |||
} | |||
</source> | |||
|helpers | |helpers | ||
|also_functions={{LSL DefineRow||[[llGetTexture]]|}} | |also_functions={{LSL DefineRow||[[llSetLinkTexture]]|}} | ||
{{LSL DefineRow||[[llGetTexture]]|}} | |||
{{LSL DefineRow||[[llSetPrimitiveParams]]|}} | |||
{{LSL DefineRow||[[llSetLinkPrimitiveParams]]|}} | |||
|also_tests | |also_tests | ||
|also_events | |also_events | ||
|also_articles | |also_articles={{LSL DefineRow||[[Internal Textures]]|}} | ||
|notes | |notes | ||
|permission | |permission | ||
Latest revision as of 05:09, 30 November 2023
| LSL Portal | Functions | Events | Types | Operators | Constants | Flow Control | Script Library | Categorized Library | Tutorials |
Summary
Function: llSetTexture( string texture, integer face );| 0.2 | Forced Delay |
| 10.0 | Energy |
Sets the Blinn-Phong diffuse texture of this prim's face.
| • string | texture | – | a texture in the inventory of the prim this script is in or a UUID of a texture | |
| • 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.
- If texture is missing from the prim's inventory and it is not a UUID or it is not a texture then an error is shouted on DEBUG_CHANNEL.
- If texture is a UUID then there are no new asset permissions consequences for the object.
- The resulting object develops no new usage restrictions that might have occurred if the asset had been placed in the prims inventory.
- Inspect does not show texture information (like creator)
Examples
default
{
state_entry()
{
// the first texture alphabetically inside the same prim's inventory
string texture = llGetInventoryName(INVENTORY_TEXTURE, 0);
// set it on all sides of the prim containing the script
llSetTexture(texture, ALL_SIDES);
}
}
See Also
Functions
| • | llSetLinkTexture | |||
| • | llGetTexture | |||
| • | llSetPrimitiveParams | |||
| • | llSetLinkPrimitiveParams |
Articles
| • | Internal Textures |
Deep Notes
Signature |
|---|
function void llSetTexture( string texture, integer face ); |