SkeletalMeshOperations.h

Go to the documentation of this file.

// Copyright Epic Games, Inc. All Rights Reserved.
 
#pragma once
 
#include "BoneIndices.h"
#include "Containers/Array.h"
#include "CoreMinimal.h"
#include "HAL/Platform.h"
#include "Logging/LogMacros.h"
#include "MeshTypes.h"
#include "StaticMeshOperations.h"
 
struct FMeshDescription;
 
 
DECLARE_LOG_CATEGORY_EXTERN(LogSkeletalMeshOperations, Log, All);
 
 
 
class FSkeletalMeshOperations : public FStaticMeshOperations
{
public:
    struct FSkeletalMeshAppendSettings
    {
        FSkeletalMeshAppendSettings()
            : SourceVertexIDOffset(0)
        {}
 
        int32 SourceVertexIDOffset;
        TArray<FBoneIndexType> SourceRemapBoneIndex;
        bool bAppendVertexAttributes = false;
    };
    
    static SKELETALMESHDESCRIPTION_API void AppendSkinWeight(const FMeshDescription& SourceMesh, FMeshDescription& TargetMesh, FSkeletalMeshAppendSettings& AppendSettings);
 
    static SKELETALMESHDESCRIPTION_API bool CopySkinWeightAttributeFromMesh(
        const FMeshDescription& InSourceMesh,
        FMeshDescription& InTargetMesh,
        const FName InSourceProfile,
        const FName InTargetProfile,
        const TMap<int32, int32>* SourceBoneIndexToTargetBoneIndexMap
        );
 
    static SKELETALMESHDESCRIPTION_API bool RemapBoneIndicesOnSkinWeightAttribute(
        FMeshDescription& InMesh,
        TConstArrayView<int32> InBoneIndexMapping
        );
 
    static SKELETALMESHDESCRIPTION_API bool GetPosedMesh(
        const FMeshDescription& InSourceMesh,
        FMeshDescription& OutTargetMesh,
        TConstArrayView<FTransform> InComponentSpaceTransforms,
        const FName InSkinWeightProfile = NAME_None,
        const TMap<FName, float>& InMorphTargetWeights = {}
        );
 
    static SKELETALMESHDESCRIPTION_API bool GetPosedMesh(
        const FMeshDescription& InSourceMesh,
        FMeshDescription& OutTargetMesh,
        const TMap<FName, FTransform>& InBoneSpaceTransforms, 
        const FName InSkinWeightProfile = NAME_None,
        const TMap<FName, float>& InMorphTargetWeights = {}
        );
 
    static SKELETALMESHDESCRIPTION_API bool GetPosedMeshInPlace(
        FMeshDescription& InOutTargetMesh,
        TConstArrayView<FTransform> InComponentSpaceTransforms,
        const FName InSkinWeightProfile = NAME_None,
        const TMap<FName, float>& InMorphTargetWeights = {},
        bool bInSkipRecomputeNormalsTangents = false,
        bool bInWriteBonePose = false
        );
 
    static SKELETALMESHDESCRIPTION_API bool GetUnposedMesh(
        const FMeshDescription& InPosedMesh,
        const FMeshDescription& InRefMesh,
        TArray<FTransform>& RefBoneTransforms,
        FMeshDescription& OutUnposedMesh,
        TConstArrayView<FTransform> InComponentSpaceTransforms,
        const FName InSkinWeightProfile,
        const TMap<FName, float>& InMorphTargetWeights
        );
 
    static SKELETALMESHDESCRIPTION_API bool GetUnposedMeshInPlace(
        FMeshDescription& InOutTargetMesh,
        const FMeshDescription& InRefMesh,
        TArray<FTransform>& RefBoneTransforms,
        TConstArrayView<FTransform> InComponentSpaceTransforms,
        const FName InSkinWeightProfile,
        const TMap<FName, float>& InMorphTargetWeights,
        bool bInWriteBonePose = false
        );
 
    static SKELETALMESHDESCRIPTION_API void ConvertHardEdgesToSmoothMasks(const FMeshDescription& InMeshDescription, TArray<uint32>& OutSmoothMasks);
 
    static SKELETALMESHDESCRIPTION_API void FixVertexInstanceStructure(FMeshDescription& SourceMeshDescription, FMeshDescription& TargetMeshDescription /*Expected to be empty*/,
        const TArray<uint32>& SourceSmoothingMasks, TArray<uint32>& TargetFaceSmoothingMasks);
 
    static SKELETALMESHDESCRIPTION_API void ValidateFixComputeMeshDescriptionData(FMeshDescription& MeshDescription, const TArray<uint32>& FaceSmoothingMasks, int32 LODIndex, const bool bComputeWeightedNormals, const FString& SkeletalMeshPath);
 
    static SKELETALMESHDESCRIPTION_API void ValidateAndFixInfluences(FMeshDescription& MeshDescription, bool& bOutInfluenceCountLimitHit);
 
    static SKELETALMESHDESCRIPTION_API void ApplyRigToGeo(FMeshDescription& RigMeshDescription /*Base/From/'Other'*/, FMeshDescription& GeoMeshDescription /*Target/To*/);
};