Component:MaterialApplyPolicy: Difference between revisions

From Resonite Wiki
Translate from Japanese and update links - please see talk page for original text
add info and finish for now
 
(2 intermediate revisions by one other user not shown)
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>


<translate>
<translate>
== Fields == <!--T:2-->
<!--T:2-->
== 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>


<translate>
<translate>
== Usage == <!--T:3-->
<!--T:3-->
== 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]].
Setting <code>CanApply</code> to false will prevent the Material Tool from applying materials to any SkinnedMeshRenderer/MeshRenderer components in the slot.
</translate>
</translate>


<translate>
<translate>
== Examples == <!--T:4-->
<!--T:4-->
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.
== 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 <code>CanApply</code> to false. Doing this will ensure that the avatar's material cannot be changed by the Material Tool.


<!--T:7-->
Adding this component to the Slot of a MeshRender and setting <code>CanApply</code> to true can allow one to explicitly change the material in specific places on small objects.
Adding this component to the Slot of a MeshRender and setting <code>CanApply</code> to true can allow one to explicitly change the material in specific places on small objects.
</translate>
</translate>


<translate>
<translate>
== Related Components == <!--T:5-->
<!--T:5-->
* [[Components:MeshRenderer|MeshRenderer]]</li>
== See Also ==
* [[Components:SkinnedMeshRenderer|SkinnedMeshRenderer]]</li>
* [[Components:MeshRenderer|MeshRenderer]]
* [[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