Component:MaterialApplyPolicy: Difference between revisions

Latest revision as of 22:57, 20 March 2025

Component image

**MaterialApplyPolicy** 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 tagged with this component onto the 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. Some components stop their functionality when this field is disabled, but some don't.
`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.

@@ Line 1: / Line 1: @@
 <languages></languages>
-<translate>
-<!--T:1-->
-{{stub}}
-(Currently written in Japanese. for native speaker: plz edit for translation from Ja later)
 {{Infobox Component
 |Image=MaterialApplyPolicyComponent.png
-|Name=Material Apply Policy
+|Name=MaterialApplyPolicy
 }}
-== Fields == <!--T:2-->
+<translate>
+<!--T:1-->
+The '''MaterialApplyPolicy''' component allows for controlling the ability for the [[Material Tool]] to apply materials to the [[Slot|slot]] hierarchy's [[Tag|tagged]] with this component onto the SkinnedMeshRenderer/MeshRenderer components.
+</translate>
+== <translate><!--T:2--> Fields</translate> ==
 {{Table ComponentFields
-|CanApply|Bool|
+|CanApply|Bool|<translate><!--T:8--> Setting this to false will prevent the [[Material Tool]] from applying materials to any SkinnedMeshRenderer/MeshRenderer components in the slot or child slots.</translate>
 }}
-== Usage == <!--T:3-->
+== <translate><!--T:3--> Usage</translate> ==
- SkinnedMeshRenderer/MeshRendererと同じSlotについている場合、MaterialTipを使ってマテリアルを適用できる機構に制限をつけるやつです。
- CanApplyを無効にするとMaterialTipを使用して適用できなくなります。
-== Examples == <!--T:4-->
+<translate>
-<li>SkinnedMeshRenderer に入れてアバターのマテリアルを変更されないようにこのコンポーネントを追加し、CanApplyをfalseに設定。</li>
+<!--T:9-->
-<li>MeshRenderer に入れて小物のマテリアルについて特定の場所が明示的に変更できるようにCanApplyをtrueに設定。</li>
+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]].
+</translate>
+== <translate><!--T:4--> Examples</translate> ==
+<translate>
+<!--T:10-->
+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.
-== Related Components == <!--T:5-->
+<!--T:7-->
-<li>[[MeshRenderer_(Component)|MeshRenderer]]</li>
+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.
-<li>[[SkinnedMeshRenderer_(Component)|SkinnedMeshRenderer]]</li>
 </translate>
-[[Category:ComponentStubs]]
+== <translate><!--T:5--> See Also</translate> ==
+* [[Components:MeshRenderer|MeshRenderer]]
+* [[Components:SkinnedMeshRenderer|SkinnedMeshRenderer]]
 [[Category:Components{{#translation:}}|Material Apply Policy]]
 [[Category:Components:Assets:Tagging{{#translation:}}|Material Apply Policy]]