Difference between revisions of "LlSetRenderMaterial"
Jump to navigation
Jump to search
m |
(Add caveat regarding the use of NULL_KEY to "unset" a glTF material.) |
||
| (2 intermediate revisions by the same user not shown) | |||
| Line 1: | Line 1: | ||
[[Category:glTF]] | |||
{{LSL_Function | {{LSL_Function | ||
|inject-2={{LSL_Function/face|face}}{{LSL_Function/inventory|material|uuid=true|type=material}} | |inject-2={{LSL_Function/face|face}}{{LSL_Function/inventory|material|uuid=true|type=material}} | ||
| Line 12: | Line 9: | ||
|p2_type=integer|p2_name=face | |p2_type=integer|p2_name=face | ||
|func_footnote | |func_footnote | ||
|func_desc=Sets the {{LSLP|material}} of this prim's {{LSLP|face}}. This function will clear most [[LlSetPrimitiveParams#PRIM_GLTF_BASE_COLOR|PRIM_GLTF_*]] properties on the face, with the exceptions of repeats, offsets, and rotation_in_radians|return_text | |func_desc=Sets the {{LSLP|material}} of this prim's {{LSLP|face}}. This function will clear most [[LlSetPrimitiveParams#PRIM_GLTF_BASE_COLOR|PRIM_GLTF_*]] properties on the face, with the exceptions of repeats, offsets, and rotation_in_radians.|return_text. | ||
|spec | |spec | ||
|constants | |constants | ||
|examples=< | |examples=<syntaxhighlight lang="lsl2"> | ||
default | default | ||
{ | { | ||
| Line 27: | Line 24: | ||
} | } | ||
} | } | ||
</ | </syntaxhighlight> | ||
|helpers | |helpers | ||
|also_functions={{LSL DefineRow||[[llSetLinkRenderMaterial]]|[[PRIM_RENDER_MATERIAL]]}} | |also_functions={{LSL DefineRow||[[llSetLinkRenderMaterial]]|[[PRIM_RENDER_MATERIAL]]}} | ||
| Line 36: | Line 33: | ||
|also_events | |also_events | ||
|notes | |notes | ||
|caveats= | |||
* If {{LSLP|material}} is provided as [[NULL_KEY]], the [[PBR_Materials|glTF Material]] is removed from {{LSLP|face}}, reverting back to any underlying [[PBR_Materials#Nomenclature_changes|Blinn-Phong]] materials. | |||
|permission | |permission | ||
|negative_index | |negative_index | ||
Latest revision as of 04:47, 17 February 2024
| LSL Portal | Functions | Events | Types | Operators | Constants | Flow Control | Script Library | Categorized Library | Tutorials |
Summary
Function: llSetRenderMaterial( string material, integer face );| 0.2 | Forced Delay |
| 10.0 | Energy |
Sets the material of this prim's face. This function will clear most PRIM_GLTF_* properties on the face, with the exceptions of repeats, offsets, and rotation_in_radians.
| • string | material | – | a material in the inventory of the prim this script is in or a UUID of a material | |
| • 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 material is missing from the prim's inventory and it is not a UUID or it is not a material then an error is shouted on DEBUG_CHANNEL.
- If material 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.
- If material is provided as NULL_KEY, the glTF Material is removed from face, reverting back to any underlying Blinn-Phong materials.
Examples
default
{
state_entry()
{
// the first material alphabetically inside the same prim's inventory
string material = llGetInventoryName(INVENTORY_MATERIAL, 0);
// set it on all sides of the prim containing the script
llSetRenderMaterial(material, ALL_SIDES);
}
}
See Also
Deep Notes
Signature |
|---|
function void llSetRenderMaterial( string material, integer face ); |