Documentation

Unity Engine


User Manual

Script Reference

Unity Engine


MaterialEditor

The Unity Material Editor.
Read time 9 minutesLast updated 5 days ago

Definition

  • Type: Class
  • Namespace: UnityEditor
  • Assembly: UnityEditor.CoreModule
  • Inherits from: Editor
[CustomEditor(typeof(Material))]public class MaterialEditor : Editor

Remarks

Extend this class to write your own custom material editor. For more detailed information see the Custom Material Editor section of the ShaderLab reference.

Static Fields

Value

Description

kMiniTextureFieldLabelIndentLevelUseful for indenting shader properties that need the same indent as mini texture field.

Properties

Property

Description

customShaderGUIReturns the custom ShaderGUI implemented by the shader.
isVisibleIs the current material expanded.

Methods

Method

Description

AwakeCalled when the Editor is woken up.
BeginAnimatedCheckCreates a Property wrapper, useful for making regular GUI controls work with MaterialProperty.
ColorPropertyDraw a property field for a color shader property.
CreatePreviewSee Editor.CreatePreview.
DefaultPreviewGUIDefault handling of preview area for materials.
DefaultPreviewSettingsGUIDefault toolbar for material preview area.
DefaultShaderPropertyHandles UI for one shader property ignoring any custom drawers.
DoubleSidedGIFieldDisplay UI for editing a material's Double Sided Global Illumination setting. Returns true if the UI is indeed displayed i.e. the material supports the Double Sided Global Illumination setting. +Additional Resources: Material.doubleSidedGI.
EmissionEnabledPropertyThis function will draw the UI for controlling whether emission is enabled or not on a material.
EnableInstancingFieldDisplay UI for editing material's render queue setting.
EndAnimatedCheckEnds a Property wrapper started with MaterialEditor.BeginAnimatedCheck.
FloatPropertyDraw a property field for a float shader property.
GetPropertyHeightCalculate height needed for the property.
GetTexturePropertyCustomAreaReturns the free rect below the label and before the large thumb object field. Is used for e.g. tiling and offset properties.
HasPreviewGUICan this component be Previewed in its current state?
HelpBoxWithButtonMake a help box with a message and button. Returns true, if button was pressed.
IntegerPropertyDraw a property field for an integer shader property.
IsInstancingEnabledDetermines whether the Enable Instancing checkbox is checked.
LightmapEmissionFlagsPropertyDraws the UI for setting the global illumination flag of a material.
LightmapEmissionPropertyThis function will draw the UI for the lightmap emission property. (None, Realtime, baked)
OnDisableCalled when the editor is disabled, if overridden please call the base OnDisable() to ensure that the material inspector is set up properly.
OnEnableCalled when the editor is enabled, if overridden please call the base OnEnable() to ensure that the material inspector is set up properly.
OnInspectorGUIImplement specific MaterialEditor GUI code here. If you want to simply extend the existing editor call the base OnInspectorGUI () before doing any custom GUI code.
OnPreviewGUICustom preview for Image component.
OnShaderChangedA callback that is invoked when a Material's Shader is changed in the Inspector.
PropertiesChangedWhenever a material property is changed call this function. This will rebuild the inspector and validate the properties.
PropertiesDefaultGUIDefault rendering of shader properties.
PropertiesGUIRender the standard material properties. This method will either render properties using a ShaderGUI instance if found otherwise it uses MaterialEditor.PropertiesDefaultGUI.
RangePropertyDraw a range slider for a range shader property.
RegisterPropertyChangeUndoCall this when you change a material property. It will add an undo for the action.
RenderQueueFieldDisplay UI for editing material's render queue setting.
RequiresConstantRepaintDoes this edit require to be repainted constantly in its current state?
SetDefaultGUIWidthsSet EditorGUIUtility.fieldWidth and labelWidth to the default values that PropertiesGUI uses.
SetShaderSet the shader of the material.
ShaderPropertyHandes UI for one shader property.
TextureCompatibilityWarningChecks if particular property has incorrect type of texture specified by the material, displays appropriate warning and suggests the user to automatically fix the problem.
TexturePropertyDraw a property field for a texture shader property.
TexturePropertyMiniThumbnailDraw a property field for a texture shader property that only takes up a single line height.
TexturePropertySingleLineMethod for showing a texture property control with additional inlined properites.
TexturePropertyTwoLinesMethod for showing a compact layout of properties.
TexturePropertyWithHDRColorMethod for showing a texture property control with a HDR color field and its color brightness float field.
TextureScaleOffsetPropertyDraws tiling and offset properties for a texture.
VectorPropertyDraw a property field for a vector shader property.

Static Methods

Method

Description

ApplyMaterialPropertyDrawersApply initial MaterialPropertyDrawer values.
BeginPropertyCreates a wrapper enabling the Unity Editor to display GUI controls for the property.
EndPropertyCloses a property wrapper that begins with MaterialEditor.BeginProperty.
FixupEmissiveFlagReturns a properly set global illlumination flag based on the passed in flag and the given color.
GetDefaultPropertyHeightCalculate height needed for the property, ignoring custom drawers.
GetFlexibleRectBetweenFieldAndRightEdgeUtility method for GUI layouting ShaderGUI. Used e.g for the rect after a left aligned Color field.
GetFlexibleRectBetweenLabelAndFieldUtility method for GUI layouting ShaderGUI.
GetLeftAlignedFieldRectUtility method for GUI layouting ShaderGUI.
GetMaterialPropertiesGet shader property information of the materials you pass in.
GetMaterialPropertyGet information about a single shader property.
GetMaterialPropertyNamesGets the shader property names of the materials you pass in.
GetRectAfterLabelWidthUtility method for GUI layouting ShaderGUI. This is the rect after the label which can be used for multiple properties. The input rect can be fetched by calling: EditorGUILayout.GetControlRect.
GetRightAlignedFieldRectUtility method for GUI layouting ShaderGUI.
TextureScaleOffsetPropertyTODO.

Inheritance

Inherited Members

Operators

Operator

Description

operator ==Compares two object references to see if they refer to the same object.
boolDetermines whether the object exists.
operator !=Compares if two objects refer to a different object.