Version: 2023.2
LanguageEnglish
  • C#

ModelImporter.SearchAndRemapMaterials

Suggest a change

Success!

Thank you for helping us improve the quality of Unity Documentation. Although we cannot accept all submissions, we do read each suggested change from our users and will make updates where applicable.

Close

Submission failed

For some reason your suggested change could not be submitted. Please <a>try again</a> in a few minutes. And thank you for taking the time to help us improve the quality of Unity Documentation.

Close

Cancel

Declaration

public bool SearchAndRemapMaterials(ModelImporterMaterialName nameOption, ModelImporterMaterialSearch searchOption);

Parameters

nameOption The name matching option.
searchOption The search type option.

Returns

bool Returns false if the source file is empty or invalid. Returns true otherwise.

Description

Search the project for matching materials and use them instead of the internal materials.

Unity uses the naming convention specified by nameOption to find and match Material assets in your project and maps them to the model. Use the search option to specify if you want the search to be done project wide, locally or recursive up from the model's location.

using UnityEditor;

public class MaterialRemapper : AssetPostprocessor { void OnPreprocessModel() { ModelImporter modelImporter = assetImporter as ModelImporter; modelImporter.SearchAndRemapMaterials(ModelImporterMaterialName.BasedOnMaterialName, ModelImporterMaterialSearch.Everywhere); } }