1. Epic GamesDeveloper
  3. FMetaHumanConformer

FMetaHumanConformer

Brief@ [FMetaHumanConformer](API\Plugins\MetaHumanCoreTechLib\FMetaHumanConformer) is a wrapper class around core tech lib that provides conformed mesh i.e. identity fitting.

API > API/Plugins > API/Plugins/MetaHumanCoreTechLib

Brief@ FMetaHumanConformer is a wrapper class around core tech lib that provides conformed mesh i.e. identity fitting.

   
Name FMetaHumanConformer
Type class
Header File /Engine/Plugins/MetaHuman/MetaHumanCoreTechLib/Source/MetaHumanCoreTechLib/Public/MetaHumanConformer.h
Include Path #include "MetaHumanConformer.h"

Syntax

class FMetaHumanConformer

Constructors

Name Remarks Include Path Unreal Specifiers

FMetaHumanConformer()

   MetaHumanConformer.h  

Structs

Name Remarks
Private  

Variables

Protected

Name Type Remarks Include Path Unreal Specifiers
AccessMutex FCriticalSection   MetaHumanConformer.h  
Impl TPimplPtr< Private >   MetaHumanConformer.h  

Functions

Public

Name Remarks Include Path Unreal Specifiers

bool ApplyDeltaDNA ( const TArray< uint8 >& InRawDNABuffer,
const TArray< uint8 >& InRawDeltaDNABuffer,
TArray< uint8 >& OutRawCombinedUnscaledDNABuffer
) const

 Apply the supplied delta DNA to the DNA, and then scale the output about the scaling pivot position, and return in the output buffer. MetaHumanConformer.h  

bool ApplyScaleToDNA ( const TArray< uint8 >& InRawDNABuffer,
float InScale,
const FVector& InScalingPivot,
TArray< uint8 >& OutRawScaledDNABuffer
) const

 Scale the supplied input DNA about the scaling pivot position, and return in the output buffer. MetaHumanConformer.h  

bool CalcTeethDepthDelta ( float InDeltaDistanceFromCamera,
float& OutDx,
float& OutDy,
float& OutDz
)

 Calculate the offset in RIG COORDINATE SPACE to move the teeth a distance InDeltaDistanceFromCamera away from the first (1st) camera. MetaHumanConformer.h  

bool CheckControlsConfig ( const FString& InControlsConfigJson
) const

 Check that the supplied json string for the controls config is valid. MetaHumanConformer.h  

EIdentityErrorCode FitIdentity ( TArray< float >& OutVerticesFace,
TArray< float >& OutVerticesLeftEye,
TArray< float >& OutVerticesRightEye,
TArray< float >& OutStackedToScanTransforms,
TArray< float >& OutStackedToScanScales,
bool bInFitEyes,
const FString& InDebuggingDataFolder
)

 Fit identity given input data. MetaHumanConformer.h  

bool FitPcaRig ( const TArray< uint8 >& InPcaRig,
const TArray< uint8 >& InNeutralDNABuffer,
TArray< float >& OutVerticesFace,
TArray< float >& OutStackedToScanTranform,
TArray< float >& OutStackedToScanScale,
const FString& InDebuggingDataFolder
)

 Fit expression using PCA rog given input data. MetaHumanConformer.h  

bool FitRigid ( TArray< float >& OutVerticesFace,
TArray< float >& OutStackedToScanTranform,
TArray< float >& OutStackedToScanScale,
int32 InIterations
)

 Fit identity given input data. MetaHumanConformer.h  

bool FitTeeth ( TArray< float >& OutVerticesTeeth,
const FString& InDebuggingDataFolder
)

 Update teeth model and position in the rig given input data. MetaHumanConformer.h  

bool GenerateBrowMeshLandmarks ( const FString& InCameraName,
TArray< uint8 >& OutJsonStream,
bool bInConcatenate
) const

 Projects brow target landmarks to fitted mesh. Outputs brows projected to mesh as mesh landmarks. MetaHumanConformer.h  

bool Init ( const FString& InTemplateDescriptionJson,
const FString& InIdentityModelJson,
const FString& InFittingConfigurationJson
)

 Initialize face fitting. MetaHumanConformer.h  

bool RefineTeethPlacement ( const FString& InControlsConfigJson,
const TArray< uint8 >& InRawDNAPlusDeltaDNABuffer,
const TArray< uint8 >& InRawDNABuffer,
TArray< uint8 >& OutRawRefinedDNAPlusDeltaDNABuffer
) const

 Refine the teeth placement provided as output from the autorigging service so that they are in a better starting position MetaHumanConformer.h  

bool ResetInputData()

 Clears previous configuration. MetaHumanConformer.h  

bool SetCameras ( const TArray< FCameraCalibration >& InCalibrations
)

 Set up the cameras for fitting. MetaHumanConformer.h  

bool SetDepthInputData ( const TMap< FString, const FFrameTrackingContourData* >& InLandmarksDataPerCamera,
const TMap< FString, const float* >& InDepthMaps
)

 Set the depth input data for one frame. Fails if scan data was set before. MetaHumanConformer.h  

bool SetModelRegularization ( float InValue
)

 Set regularization for non-rigid fitting. MetaHumanConformer.h  

bool SetScanInputData ( const TSortedMap< FString, const FFrameTrackingContourData* >& InLandmarks2DData,
const TSortedMap< FString, const FTrackingContour3D* >& InLandmarks3DData,
const TArray< int32_t >& InTrianlges,
const TArray< float >& InVertices,
bool& bOutInvalidMeshTopology
)

 Set the scan input data. Fails if depthmap data was set before. MetaHumanConformer.h  

bool TransformRigOrigin ( const TArray< uint8 >& InRawDNABuffer,
const FMatrix44f& InTransformMatrix,
TArray< uint8 >& OutTransformedDNABuffer
) const

 Apply the supplied rigid transform to the input DNA, and and return in the output buffer. MetaHumanConformer.h  

bool UpdateRigWithTeethMeshVertices ( const TArray< uint8 >& InDNA,
const TArray< float >& InVertices,
TArray< uint8 >& OutDNA
)

 Update teeth model and position in the rig given input data. MetaHumanConformer.h  

bool UpdateTeethSource ( const TArray< uint8 >& InDNA
)

 Update the teeth source for the conformer from the supplied DNA MetaHumanConformer.h  

Static

Name Remarks Include Path Unreal Specifiers

static bool CalculatePcaModelFromDnaRig ( const FString& InConfigurationFilename,
const FString& InDNAFilename,
TArray< uint8 >& OutPCARigMemoryBuffer
)

 Creates a PCA rig out of input DNA RigLogic rig. MetaHumanConformer.h  

static bool CalculatePcaModelFromDnaRig ( const FString& InConfigurationJson,
const TArray< uint8 >& InDNA,
TArray< uint8 >& OutPCARigMemoryBuffer,
const FString& InDebuggingDataFolder
)

 Creates a PCA rig out of input DNA RigLogic rig. MetaHumanConformer.h  

static bool CheckPcaModelFromDnaRigConfig ( const FString& InConfigurationJson,
UDNAAsset* InDNAAsset
)

 Check that the supplied PCA from DNA rig config is valid. MetaHumanConformer.h  

static TArray< uint8 > DNAToBuffer ( UDNAAsset* InDNAAsset
)

 Converts a DNA asset into a byte array. MetaHumanConformer.h  

Ask questions and help your peers Developer Forums

Write your own tutorials or read those from others Learning Library

On this page