// Copyright Epic Games, Inc. All Rights Reserved. #pragma once #include "CoreMinimal.h" #include "MeshTypes.h" struct FMeshDescription; struct FOverlappingCorners; struct FPolygonGroupID; struct FRawMesh; struct FUVMapParameters; enum class ELightmapUVVersion : int32; typedef TMap PolygonGroupMap; DECLARE_LOG_CATEGORY_EXTERN(LogStaticMeshOperations, Log, All); DECLARE_DELEGATE_ThreeParams(FAppendPolygonGroupsDelegate, const FMeshDescription& /*SourceMesh*/, FMeshDescription& /*TargetMesh*/, PolygonGroupMap& /*RemapPolygonGroup*/) enum class EComputeNTBsFlags : uint32 { None = 0x00000000, // No flags Normals = 0x00000001, //Force-recompute the normals and implicitly force the recomputing of tangents. Tangents = 0x00000002, //Force-recompute the tangents. UseMikkTSpace = 0x00000004, //Used when force-recomputing the tangents, use MikkTSpace. WeightedNTBs = 0x00000008, //Use weight surface area and angle when computing NTBs to proportionally distribute the vertex instance contribution to the normal/tangent/binormal in a smooth group. i.e. Weight solve the cylinder problem BlendOverlappingNormals = 0x00000010, IgnoreDegenerateTriangles = 0x00000020, }; ENUM_CLASS_FLAGS(EComputeNTBsFlags); class STATICMESHDESCRIPTION_API FStaticMeshOperations { public: struct FAppendSettings { FAppendSettings() : bMergeVertexColor(true) , bMergeUVChannels{ true } , MergedAssetPivot(0.0f, 0.0f, 0.0f) {} enum { MAX_NUM_UV_CHANNELS = 8, }; FAppendPolygonGroupsDelegate PolygonGroupsDelegate; bool bMergeVertexColor; bool bMergeUVChannels[MAX_NUM_UV_CHANNELS]; FVector MergedAssetPivot; TOptional MeshTransform; // Apply a transformation on source mesh (see MeshTransform) }; /** Set the polygon tangent, normal, binormal and polygonCenter for all polygons in the mesh description. */ UE_DEPRECATED(4.26, "Please use ComputeTriangleTangentsAndNormals() instead.") static void ComputePolygonTangentsAndNormals(FMeshDescription& MeshDescription, float ComparisonThreshold = 0.0f); /** Set the triangle tangent, normal, binormal and triangleCenter for all triangles in the mesh description. */ static void ComputeTriangleTangentsAndNormals(FMeshDescription& MeshDescription, float ComparisonThreshold = 0.0f); /** * Recompute any invalid normal, tangent or Bi-Normal for every vertex in the mesh description with the given options. * If the EComputeNTBsFlags Normals or Tangents are set, the corresponding data will be force-recomputed. */ static void ComputeTangentsAndNormals(FMeshDescription& MeshDescription, EComputeNTBsFlags ComputeNTBsOptions); /* * Make sure all normals and tangents are valid. If not, recompute them. */ static void RecomputeNormalsAndTangentsIfNeeded(FMeshDescription& MeshDescription, EComputeNTBsFlags ComputeNTBsOptions); /** Compute tangent and Bi-Normal using mikkt space for every vertex in the mesh description. */ static void ComputeMikktTangents(FMeshDescription& MeshDescription, bool bIgnoreDegenerateTriangles); /** Determine the edge hardnesses from existing normals */ static void DetermineEdgeHardnessesFromVertexInstanceNormals(FMeshDescription& MeshDescription, float Tolerance = UE_KINDA_SMALL_NUMBER); /** Convert this mesh description into the old FRawMesh format. */ static void ConvertToRawMesh(const FMeshDescription& SourceMeshDescription, FRawMesh& DestinationRawMesh, const TMap& MaterialMap); /** Convert old FRawMesh format to MeshDescription. */ static void ConvertFromRawMesh(const FRawMesh& SourceRawMesh, FMeshDescription& DestinationMeshDescription, const TMap& MaterialMap, bool bSkipNormalsAndTangents = false); static void AppendMeshDescription(const FMeshDescription& SourceMesh, FMeshDescription& TargetMesh, FAppendSettings& AppendSettings); static void AppendMeshDescriptions(const TArray& SourceMeshes, FMeshDescription& TargetMesh, FAppendSettings& AppendSettings); static void AreNormalsAndTangentsValid(const FMeshDescription& MeshDescription, bool& bHasInvalidNormals, bool& bHasInvalidTangents); /** Find all overlapping vertex using the threshold in the mesh description. */ static void FindOverlappingCorners(FOverlappingCorners& OverlappingCorners, const FMeshDescription& MeshDescription, float ComparisonThreshold); /** Find all charts in the mesh description. */ static int32 GetUVChartCount(FMeshDescription& MeshDescription, int32 SrcLightmapIndex, ELightmapUVVersion LightmapUVVersion, const FOverlappingCorners& OverlappingCorners); /** * Find and pack UV charts for lightmap. * The packing algorithm uses a rasterization method, hence the resolution parameter. * * If the given minimum resolution is not enough to handle all the charts, generation will fail. * * @param MeshDescription Edited mesh * @param SrcLightmapIndex index of the source UV channel * @param DstLightmapIndex index of the destination UV channel * @param MinLightmapResolution Minimum resolution used for the packing * @param LightmapUVVersion Algorithm version * @param OverlappingCorners Overlapping corners of the given mesh * @return UV layout correctly generated */ static bool CreateLightMapUVLayout(FMeshDescription& MeshDescription, int32 SrcLightmapIndex, int32 DstLightmapIndex, int32 MinLightmapResolution, ELightmapUVVersion LightmapUVVersion, const FOverlappingCorners& OverlappingCorners); /** Create some UVs from the specified mesh description data. */ static bool GenerateUniqueUVsForStaticMesh(const FMeshDescription& MeshDescription, int32 TextureResolution, bool bMergeIdenticalMaterials, TArray& OutTexCoords); /** Add a UV channel to the MeshDescription. */ static bool AddUVChannel(FMeshDescription& MeshDescription); /** Insert a UV channel at the given index to the MeshDescription. */ static bool InsertUVChannel(FMeshDescription& MeshDescription, int32 UVChannelIndex); /** Remove the UV channel at the given index from the MeshDescription. */ static bool RemoveUVChannel(FMeshDescription& MeshDescription, int32 UVChannelIndex); /** Generate planar UV mapping for the MeshDescription */ static void GeneratePlanarUV(const FMeshDescription& MeshDescription, const FUVMapParameters& Params, TMap& OutTexCoords); /** Generate cylindrical UV mapping for the MeshDescription */ static void GenerateCylindricalUV(FMeshDescription& MeshDescription, const FUVMapParameters& Params, TMap& OutTexCoords); /** Generate box UV mapping for the MeshDescription */ static void GenerateBoxUV(const FMeshDescription& MeshDescription, const FUVMapParameters& Params, TMap& OutTexCoords); //static void RemapPolygonGroups(FMeshDescription& MeshDescription, TMap& Remap); /* * Move some polygon to a new PolygonGroup(section) * SectionIndex: The target section we want to assign the polygon. See bRemoveEmptyPolygonGroup to know how its used * TriangleIndexStart: The triangle index is compute as follow: foreach polygon {TriangleIndex += Polygon->NumberTriangles} * TriangleIndexEnd: The triangle index is compute as follow: foreach polygon {TriangleIndex += Polygon->NumberTriangles} * bRemoveEmptyPolygonGroup: If true, any polygonGroup that is empty after moving a polygon will be delete. * This parameter impact how SectionIndex is use * If param is true : PolygonGroupTargetID.GetValue() do not necessary equal SectionIndex in case there is less sections then SectionIndex * If param is false : PolygonGroupTargetID.GetValue() equal SectionIndex, we will add all necessary missing PolygonGroupID (this can generate empty PolygonGroupID) */ static void SwapPolygonPolygonGroup(FMeshDescription& MeshDescription, int32 SectionIndex, int32 TriangleIndexStart, int32 TriangleIndexEnd, bool bRemoveEmptyPolygonGroup); static void ConvertHardEdgesToSmoothGroup(const FMeshDescription& SourceMeshDescription, TArray& FaceSmoothingMasks); static void ConvertSmoothGroupToHardEdges(const TArray& FaceSmoothingMasks, FMeshDescription& DestinationMeshDescription); static bool HasVertexColor(const FMeshDescription& MeshDescription); static void BuildWeldedVertexIDRemap(const FMeshDescription& MeshDescription, const float WeldingThreshold, TMap& OutVertexIDRemap); /** Computes the SHA hash of all the attributes values in the MeshDescription. * @param bSkipTransientAttributes If param is true, do not include transient attributes in the hash computation. */ static FSHAHash ComputeSHAHash(const FMeshDescription& MeshDescription, bool bSkipTransientAttributes = false); /** Flip the facing for a set of input polygons. */ static void FlipPolygons(FMeshDescription& MeshDescription); /** Transforms the MeshDescription data using the provided transform. */ static void ApplyTransform(FMeshDescription& MeshDescription, const FTransform& Transform); };