347 lines
11 KiB
C
347 lines
11 KiB
C
|
// Copyright Epic Games, Inc. All Rights Reserved.
|
||
|
|
|
||
|
|
/**
|
||
|
|
* MaterialEditorInstanceConstant.h: This class is used by the material instance editor to hold a set of inherited parameters which are then pushed to a material instance.
|
||
|
|
*/
|
||
|
|
|
||
|
|
#pragma once
|
||
|
|
|
||
|
|
#include "CoreMinimal.h"
|
||
|
|
#include "UObject/ObjectMacros.h"
|
||
|
|
#include "UObject/Object.h"
|
||
|
|
#include "Misc/Guid.h"
|
||
|
|
#include "StaticParameterSet.h"
|
||
|
|
#include "Editor/UnrealEdTypes.h"
|
||
|
|
#include "Materials/MaterialInstanceBasePropertyOverrides.h"
|
||
|
|
#include "Materials/MaterialExpression.h"
|
||
|
|
#include "MaterialEditorInstanceConstant.generated.h"
|
||
|
|
|
||
|
|
class UDEditorParameterValue;
|
||
|
|
class UMaterial;
|
||
|
|
class UMaterialInstanceConstant;
|
||
|
|
struct FPropertyChangedEvent;
|
||
|
|
|
||
|
|
USTRUCT()
|
||
|
|
struct FEditorParameterGroup
|
||
|
|
{
|
||
|
|
GENERATED_USTRUCT_BODY()
|
||
|
|
|
||
|
|
FEditorParameterGroup()
|
||
|
|
: GroupAssociation(GlobalParameter), GroupSortPriority(0)
|
||
|
|
{}
|
||
|
|
|
||
|
|
UPROPERTY()
|
||
|
|
FName GroupName;
|
||
|
|
|
||
|
|
UPROPERTY()
|
||
|
|
TEnumAsByte<EMaterialParameterAssociation> GroupAssociation = EMaterialParameterAssociation::LayerParameter;
|
||
|
|
|
||
|
|
UPROPERTY(EditAnywhere, editfixedsize, Instanced, Category = EditorParameterGroup)
|
||
|
|
TArray<class UDEditorParameterValue*> Parameters;
|
||
|
|
|
||
|
|
UPROPERTY()
|
||
|
|
int32 GroupSortPriority = 0;
|
||
|
|
};
|
||
|
|
|
||
|
|
USTRUCT()
|
||
|
|
struct FEditorParameterValue
|
||
|
|
{
|
||
|
|
GENERATED_USTRUCT_BODY()
|
||
|
|
|
||
|
|
UPROPERTY(EditAnywhere, Category = EditorParameterValue)
|
||
|
|
uint32 bOverride : 1;
|
||
|
|
|
||
|
|
UPROPERTY(EditAnywhere, Category = EditorParameterValue)
|
||
|
|
FMaterialParameterInfo ParameterInfo;
|
||
|
|
|
||
|
|
UPROPERTY()
|
||
|
|
FGuid ExpressionId;
|
||
|
|
|
||
|
|
FEditorParameterValue()
|
||
|
|
: bOverride(false)
|
||
|
|
{
|
||
|
|
}
|
||
|
|
};
|
||
|
|
|
||
|
|
USTRUCT()
|
||
|
|
struct FEditorVectorParameterValue: public FEditorParameterValue
|
||
|
|
{
|
||
|
|
GENERATED_USTRUCT_BODY()
|
||
|
|
|
||
|
|
UPROPERTY(EditAnywhere, Category = EditorVectorParameterValue)
|
||
|
|
FLinearColor ParameterValue;
|
||
|
|
|
||
|
|
FEditorVectorParameterValue()
|
||
|
|
: ParameterValue(ForceInit)
|
||
|
|
{
|
||
|
|
}
|
||
|
|
};
|
||
|
|
|
||
|
|
USTRUCT()
|
||
|
|
struct FEditorScalarParameterValue: public FEditorParameterValue
|
||
|
|
{
|
||
|
|
GENERATED_USTRUCT_BODY()
|
||
|
|
|
||
|
|
UPROPERTY(EditAnywhere, Category = EditorScalarParameterValue)
|
||
|
|
float ParameterValue;
|
||
|
|
|
||
|
|
FEditorScalarParameterValue()
|
||
|
|
: ParameterValue(0)
|
||
|
|
{
|
||
|
|
}
|
||
|
|
};
|
||
|
|
|
||
|
|
USTRUCT()
|
||
|
|
struct FEditorTextureParameterValue: public FEditorParameterValue
|
||
|
|
{
|
||
|
|
GENERATED_USTRUCT_BODY()
|
||
|
|
|
||
|
|
UPROPERTY(EditAnywhere, Category = EditorTextureParameterValue)
|
||
|
|
class UTexture* ParameterValue;
|
||
|
|
|
||
|
|
FEditorTextureParameterValue()
|
||
|
|
: ParameterValue(NULL)
|
||
|
|
{
|
||
|
|
}
|
||
|
|
};
|
||
|
|
|
||
|
|
USTRUCT()
|
||
|
|
struct FEditorFontParameterValue: public FEditorParameterValue
|
||
|
|
{
|
||
|
|
GENERATED_USTRUCT_BODY()
|
||
|
|
|
||
|
|
UPROPERTY(EditAnywhere, Category = EditorFontParameterValue)
|
||
|
|
class UFont* FontValue;
|
||
|
|
|
||
|
|
UPROPERTY(EditAnywhere, Category = EditorFontParameterValue)
|
||
|
|
int32 FontPage;
|
||
|
|
|
||
|
|
FEditorFontParameterValue()
|
||
|
|
: FontValue(NULL), FontPage(0)
|
||
|
|
{
|
||
|
|
}
|
||
|
|
};
|
||
|
|
|
||
|
|
USTRUCT()
|
||
|
|
struct FEditorMaterialLayersParameterValue: public FEditorParameterValue
|
||
|
|
{
|
||
|
|
GENERATED_USTRUCT_BODY()
|
||
|
|
|
||
|
|
UPROPERTY(EditAnywhere, Category = EditorLayersParameterValue)
|
||
|
|
class UMaterialFunctionInterface* FunctionValue;
|
||
|
|
|
||
|
|
FEditorMaterialLayersParameterValue()
|
||
|
|
: FunctionValue(NULL)
|
||
|
|
{
|
||
|
|
}
|
||
|
|
};
|
||
|
|
|
||
|
|
USTRUCT()
|
||
|
|
struct FEditorStaticSwitchParameterValue: public FEditorParameterValue
|
||
|
|
{
|
||
|
|
GENERATED_USTRUCT_BODY()
|
||
|
|
|
||
|
|
UPROPERTY(EditAnywhere, Category = EditorStaticSwitchParameterValue)
|
||
|
|
uint32 ParameterValue : 1;
|
||
|
|
|
||
|
|
FEditorStaticSwitchParameterValue()
|
||
|
|
: ParameterValue(false)
|
||
|
|
{
|
||
|
|
}
|
||
|
|
|
||
|
|
/** Constructor */
|
||
|
|
FEditorStaticSwitchParameterValue(const FStaticSwitchParameter& InParameter)
|
||
|
|
: ParameterValue(InParameter.Value)
|
||
|
|
{
|
||
|
|
// initialize base class members
|
||
|
|
bOverride = InParameter.bOverride;
|
||
|
|
ParameterInfo = InParameter.ParameterInfo;
|
||
|
|
ExpressionId = InParameter.ExpressionGUID;
|
||
|
|
}
|
||
|
|
};
|
||
|
|
|
||
|
|
USTRUCT()
|
||
|
|
struct FComponentMaskParameter
|
||
|
|
{
|
||
|
|
GENERATED_USTRUCT_BODY()
|
||
|
|
|
||
|
|
UPROPERTY(EditAnywhere, Category = ComponentMaskParameter)
|
||
|
|
uint32 R : 1;
|
||
|
|
|
||
|
|
UPROPERTY(EditAnywhere, Category = ComponentMaskParameter)
|
||
|
|
uint32 G : 1;
|
||
|
|
|
||
|
|
UPROPERTY(EditAnywhere, Category = ComponentMaskParameter)
|
||
|
|
uint32 B : 1;
|
||
|
|
|
||
|
|
UPROPERTY(EditAnywhere, Category = ComponentMaskParameter)
|
||
|
|
uint32 A : 1;
|
||
|
|
|
||
|
|
FComponentMaskParameter()
|
||
|
|
: R(false), G(false), B(false), A(false)
|
||
|
|
{
|
||
|
|
}
|
||
|
|
|
||
|
|
/** Constructor */
|
||
|
|
FComponentMaskParameter(bool InR, bool InG, bool InB, bool InA): R(InR),
|
||
|
|
G(InG),
|
||
|
|
B(InB),
|
||
|
|
A(InA)
|
||
|
|
{
|
||
|
|
}
|
||
|
|
};
|
||
|
|
|
||
|
|
USTRUCT()
|
||
|
|
struct FEditorStaticComponentMaskParameterValue: public FEditorParameterValue
|
||
|
|
{
|
||
|
|
GENERATED_USTRUCT_BODY()
|
||
|
|
|
||
|
|
UPROPERTY(EditAnywhere, Category = EditorStaticComponentMaskParameterValue)
|
||
|
|
struct FComponentMaskParameter ParameterValue;
|
||
|
|
|
||
|
|
/** Constructor */
|
||
|
|
FEditorStaticComponentMaskParameterValue() {}
|
||
|
|
FEditorStaticComponentMaskParameterValue(const FStaticComponentMaskParameter& InParameter)
|
||
|
|
: ParameterValue(InParameter.R, InParameter.G, InParameter.B, InParameter.A)
|
||
|
|
{
|
||
|
|
// initialize base class members
|
||
|
|
bOverride = InParameter.bOverride;
|
||
|
|
ParameterInfo = InParameter.ParameterInfo;
|
||
|
|
ExpressionId = InParameter.ExpressionGUID;
|
||
|
|
}
|
||
|
|
};
|
||
|
|
|
||
|
|
UCLASS(hidecategories = Object, collapsecategories)
|
||
|
|
class UNREALED_API UMaterialEditorInstanceConstant: public UObject
|
||
|
|
{
|
||
|
|
GENERATED_UCLASS_BODY()
|
||
|
|
|
||
|
|
/** Overrider Material Parameter Collections */
|
||
|
|
UPROPERTY(EditAnywhere, editfixedsize, Instanced, Category = MaterialEditorInstanceConstant)
|
||
|
|
TArray<class UDEditorMPCValue*> ParameterCollections;
|
||
|
|
|
||
|
|
/** Physical material to use for this graphics material. Used for sounds, effects etc.*/
|
||
|
|
UPROPERTY(EditAnywhere, Category = MaterialEditorInstanceConstant)
|
||
|
|
class UPhysicalMaterial* PhysMaterial;
|
||
|
|
|
||
|
|
// since the Parent may point across levels and the property editor needs to import this text, it must be marked lazy so it doesn't set itself to NULL in FindImportedObject
|
||
|
|
UPROPERTY(EditAnywhere, Category = MaterialEditorInstanceConstant, meta = (DisplayThumbnail = "true"))
|
||
|
|
class UMaterialInterface* Parent;
|
||
|
|
|
||
|
|
UPROPERTY(EditAnywhere, editfixedsize, Category = MaterialEditorInstanceConstant)
|
||
|
|
TArray<struct FEditorParameterGroup> ParameterGroups;
|
||
|
|
|
||
|
|
UPROPERTY(EditAnywhere, Category = MaterialEditorInstanceConstant, meta = (DisplayThumbnail = "true"))
|
||
|
|
class UMaterialInterface* NextPass;
|
||
|
|
|
||
|
|
/** This is the refraction depth bias, larger values offset distortion to prevent closer objects from rendering into the distorted surface at acute viewing angles but increases the disconnect between surface and where the refraction starts. */
|
||
|
|
UPROPERTY(EditAnywhere, Category = MaterialEditorInstanceConstant)
|
||
|
|
float RefractionDepthBias;
|
||
|
|
|
||
|
|
/** SubsurfaceProfile, for Screen Space Subsurface Scattering */
|
||
|
|
UPROPERTY(EditAnywhere, BlueprintReadOnly, Category = Material, meta = (DisplayName = "Subsurface Profile"))
|
||
|
|
class USubsurfaceProfile* SubsurfaceProfile;
|
||
|
|
|
||
|
|
/** Defines if SubsurfaceProfile from tis instance is used or it uses the parent one. */
|
||
|
|
UPROPERTY(EditAnywhere, Category = MaterialEditorInstanceConstant)
|
||
|
|
uint32 bOverrideSubsurfaceProfile : 1;
|
||
|
|
|
||
|
|
UPROPERTY()
|
||
|
|
uint32 bOverrideBaseProperties_DEPRECATED : 1;
|
||
|
|
|
||
|
|
UPROPERTY(transient, duplicatetransient)
|
||
|
|
uint32 bIsFunctionPreviewMaterial : 1;
|
||
|
|
|
||
|
|
UPROPERTY(transient, duplicatetransient)
|
||
|
|
uint32 bIsFunctionInstanceDirty : 1;
|
||
|
|
|
||
|
|
UPROPERTY(EditAnywhere, Category = MaterialOverrides)
|
||
|
|
FMaterialInstanceBasePropertyOverrides BasePropertyOverrides;
|
||
|
|
|
||
|
|
UPROPERTY()
|
||
|
|
class UMaterialInstanceConstant* SourceInstance;
|
||
|
|
|
||
|
|
UPROPERTY()
|
||
|
|
class UMaterialFunctionInstance* SourceFunction;
|
||
|
|
|
||
|
|
UPROPERTY(transient, duplicatetransient)
|
||
|
|
TArray<FMaterialParameterInfo> VisibleExpressions;
|
||
|
|
|
||
|
|
/** The Lightmass override settings for this object. */
|
||
|
|
UPROPERTY(EditAnywhere, Category = Lightmass)
|
||
|
|
struct FLightmassParameterizedMaterialSettings LightmassSettings;
|
||
|
|
|
||
|
|
/** Should we use old style typed arrays for unassigned parameters instead of a None group (new style)? */
|
||
|
|
UPROPERTY(EditAnywhere, Category = MaterialEditorInstanceConstant)
|
||
|
|
uint32 bUseOldStyleMICEditorGroups : 1;
|
||
|
|
|
||
|
|
//~ Begin UObject Interface.
|
||
|
|
virtual void PostEditChangeProperty(FPropertyChangedEvent& PropertyChangedEvent) override;
|
||
|
|
#if WITH_EDITOR
|
||
|
|
virtual void PostEditUndo() override;
|
||
|
|
#endif
|
||
|
|
//~ End UObject Interface.
|
||
|
|
|
||
|
|
/** Regenerates the parameter arrays. */
|
||
|
|
void RegenerateArrays();
|
||
|
|
#if WITH_EDITOR
|
||
|
|
/** Sets back to zero the overrides for any parameters copied out of the layer stack */
|
||
|
|
void CleanParameterStack(int32 Index, EMaterialParameterAssociation MaterialType);
|
||
|
|
/** Copies the overrides for any parameters copied out of the layer stack from the layer or blend */
|
||
|
|
void ResetOverrides(int32 Index, EMaterialParameterAssociation MaterialType);
|
||
|
|
#endif
|
||
|
|
/** Copies the parameter array values back to the source instance. */
|
||
|
|
void CopyToSourceInstance(const bool bForceStaticPermutationUpdate = false);
|
||
|
|
|
||
|
|
void ApplySourceFunctionChanges();
|
||
|
|
|
||
|
|
/** Builds a FStaticParameterSet for the source UMaterialInstance to store. The built set has only parameters overridden by this instance. */
|
||
|
|
void BuildStaticParametersForSourceInstance(FStaticParameterSet& OutStaticParameters);
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Sets the source instance for this object and regenerates arrays.
|
||
|
|
*
|
||
|
|
* @param MaterialInterface Instance to use as the source for this material editor instance.
|
||
|
|
*/
|
||
|
|
void SetSourceInstance(UMaterialInstanceConstant* MaterialInterface);
|
||
|
|
|
||
|
|
void CopyBasePropertiesFromParent();
|
||
|
|
|
||
|
|
void SetSourceFunction(UMaterialFunctionInstance* MaterialFunction);
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Update the source instance parent to match this
|
||
|
|
*/
|
||
|
|
void UpdateSourceInstanceParent();
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Returns group for parameter. Creates one if needed.
|
||
|
|
*
|
||
|
|
* @param ParameterGroup Name to be looked for.
|
||
|
|
*/
|
||
|
|
FEditorParameterGroup& GetParameterGroup(FName& ParameterGroup);
|
||
|
|
/**
|
||
|
|
* Creates/adds value to group retrieved from parent material .
|
||
|
|
*
|
||
|
|
* @param ParentMaterial Name of material to search for groups.
|
||
|
|
* @param ParameterValue Current data to be grouped
|
||
|
|
* @param OptionalGroupName Optional Group Name that be used directly instead of resolving it from the material
|
||
|
|
*/
|
||
|
|
void AssignParameterToGroup(UMaterial* ParentMaterial, UDEditorParameterValue* ParameterValue, const FName* OptionalGroupName = nullptr);
|
||
|
|
|
||
|
|
static FName GlobalGroupPrefix;
|
||
|
|
|
||
|
|
TWeakPtr<class IDetailsView> DetailsView;
|
||
|
|
|
||
|
|
#if WITH_EDITORONLY_DATA
|
||
|
|
UPROPERTY()
|
||
|
|
TArray<class UMaterialInstanceConstant*> StoredLayerPreviews;
|
||
|
|
|
||
|
|
UPROPERTY()
|
||
|
|
TArray<class UMaterialInstanceConstant*> StoredBlendPreviews;
|
||
|
|
#endif
|
||
|
|
|
||
|
|
/** Whether or not we should show only overridden properties*/
|
||
|
|
bool bShowOnlyOverrides;
|
||
|
|
};
|