Navigation
API > API/Editor > API/Editor/MaterialEditor > API/Editor/MaterialEditor/UMaterialEditingLibrary
Description
Renames a material parameter group within the specified material.
This function allows you to rename an existing parameter group in a material. It iterates all parameters within the material, finds all the one belonging to the OldGroupName_ group and switches those parameters to be in the NewGroupName_ group. This function only affects parameters that belong to the specified group.
To remove the groups from the parameters the new group name can be 'None'. If the OldGroupName does not exist in the material, the function will return false. If the NewGroupName already exists, the parameters will be "merged" into the existing group.
| Name | RenameMaterialParameterGroup |
| Type | function |
| Header File | /Engine/Source/Editor/MaterialEditor/Public/MaterialEditingLibrary.h |
| Include Path | #include "MaterialEditingLibrary.h" |
| Source | /Engine/Source/Editor/MaterialEditor/Private/MaterialEditingLibrary.cpp |
UFUNCTION (BlueprintCallable, Category="MaterialEditing")
static bool RenameMaterialParameterGroup
(
UMaterial * Material,
const FName OldGroupName,
const FName NewGroupName
)
true if the rename operation was successful; false otherwise.
Parameters
| Name | Remarks |
|---|---|
| Material | The material asset in which the parameter group resides. |
| OldGroupName | The current name of the parameter group to rename. |
| NewGroupName | The new name to assign to the parameter group. |