Component:MaterialApplyPolicy: Difference between revisions

From Resonite Wiki
Marked this version for translation
add info and finish for now
 
Line 2: Line 2:
<translate>
<translate>
<!--T:1-->
<!--T:1-->
{{stub}}
{{Infobox Component
{{Infobox Component
|Image=MaterialApplyPolicyComponent.png
|Image=MaterialApplyPolicyComponent.png
|Name=Material Apply Policy
|Name=Material Apply Policy
}}
}}
The '''MaterialApplyPolicy''' component allows for controlling the ability for the [[Material Tool]] to apply materials to the slot hierarchy's SkinnedMeshRenderer/MeshRenderer components.
</translate>
</translate>


Line 13: Line 13:
== Fields ==
== Fields ==
{{Table ComponentFields
{{Table ComponentFields
|CanApply|Bool|
|CanApply|Bool|Setting this to false will prevent the [[Material Tool]] from applying materials to any SkinnedMeshRenderer/MeshRenderer components in the slot or child slots.
}}
}}
</translate>
</translate>
Line 21: Line 21:
== Usage ==
== Usage ==
When this component is added to a [[Slot]] with a [[Component:SkinnedMeshRenderer|SkinnedMeshRenderer]] or [[Component:MeshRenderer|MeshRenderer]] attached, it allows one to limit the effects of the [[Material Tool]].
When this component is added to a [[Slot]] with a [[Component:SkinnedMeshRenderer|SkinnedMeshRenderer]] or [[Component:MeshRenderer|MeshRenderer]] attached, it allows one to limit the effects of the [[Material Tool]].
<!--T:6-->
Setting <code>CanApply</code> to false will prevent the Material Tool from applying materials to any SkinnedMeshRenderer/MeshRenderer components in the slot.
</translate>
</translate>


Line 29: Line 26:
<!--T:4-->
<!--T:4-->
== Examples ==
== Examples ==
On an avatar, you can try adding this component to the Slot of each SkinnedMeshRender, setting <code>CanApply</code> to false in each case. Doing this will ensure that the avatar's material cannot be changed by the Material Tool.
On an avatar, you can try adding this component to the root of the avatar, making sure the avatar has a [[Component:ObjectRoot]], and set <code>CanApply</code> to false. Doing this will ensure that the avatar's material cannot be changed by the Material Tool.


<!--T:7-->
<!--T:7-->
Line 37: Line 34:
<translate>
<translate>
<!--T:5-->
<!--T:5-->
== Related Components ==
== See Also ==
* [[Components:MeshRenderer|MeshRenderer]]
* [[Components:MeshRenderer|MeshRenderer]]
* [[Components:SkinnedMeshRenderer|SkinnedMeshRenderer]]
* [[Components:SkinnedMeshRenderer|SkinnedMeshRenderer]]
</translate>
</translate>
[[Category:ComponentStubs]]
[[Category:Components{{#translation:}}|Material Apply Policy]]
[[Category:Components{{#translation:}}|Material Apply Policy]]
[[Category:Components:Assets:Tagging{{#translation:}}|Material Apply Policy]]
[[Category:Components:Assets:Tagging{{#translation:}}|Material Apply Policy]]

Latest revision as of 19:35, 22 December 2024

Component image 
Material Apply Policy component as seen in the Scene Inspector

The MaterialApplyPolicy component allows for controlling the ability for the Material Tool to apply materials to the slot hierarchy's SkinnedMeshRenderer/MeshRenderer components.

Fields

Fields
Name Type Description
persistent Bool Determines whether or not this item will be saved to the server.
UpdateOrder Int Controls the order in which this component is updated.
Enabled Bool Controls whether or not this component is enabled.
CanApply Bool Setting this to false will prevent the Material Tool from applying materials to any SkinnedMeshRenderer/MeshRenderer components in the slot or child slots.

Usage

When this component is added to a Slot with a SkinnedMeshRenderer or MeshRenderer attached, it allows one to limit the effects of the Material Tool.

Examples

On an avatar, you can try adding this component to the root of the avatar, making sure the avatar has a Component:ObjectRoot, and set CanApply to false. Doing this will ensure that the avatar's material cannot be changed by the Material Tool.

Adding this component to the Slot of a MeshRender and setting CanApply to true can allow one to explicitly change the material in specific places on small objects.

See Also