1. Epic GamesDeveloper
  3. FFFDLattice

FFFDLattice

Free-form deformation lattice.

API > API/Plugins > API/Plugins/DynamicMesh > API/Plugins/DynamicMesh/Operations

References

   
Module DynamicMesh
Header /Engine/Plugins/Runtime/GeometryProcessing/Source/DynamicMesh/Public/Operations/FFDLattice.h
Include #include "Operations/FFDLattice.h"

Syntax

class FFFDLattice

Remarks

Free-form deformation lattice. Initialize it with a mesh and desired resolution, get the initial lattice points out. Then pass in deformed lattice points and it will compute deformed mesh vertex positions.

Variables

  Type Name Description
Protected variable FVector3d CellSize 3D size of a lattice cell
Protected variable FVector3i Dimensions Number of lattice points in each dimension.
Protected variable FAxisAlignedBox3d InitialBounds Extents of the lattice before it is deformed.
Protected variable TArray< FEmbedding > VertexEmbeddings Interpolation weights and cell indices per vertex of the input FDynamicMesh3.

Constructors

  Type Name Description
Public function  

FFFDLattice ( const FVector3i& InDims,
const FDynamicMesh3& InMesh,
float Padding
)

 Create a lattice that fits the given mesh and has the given resolution along each dimension.

Functions

  Type Name Description
Protected function Const FVector3d

ClosestLatticePosition ( const FVector3i& VirtualControlPointIndex,
const TArray< FVector3d >& LatticeControlPoints
)

 Clamp the given index to [0, Dims] and return the current lattice point position at the clamped index.
Protected function void For each vertex in Mesh, compute the lattice cell it resides in and its weighting.
Protected function Const FVector3d

ComputeTrilinearWeights ( const FVector3d& Pt,
FVector3i& GridCoordinates
)

 Compute cell index and linear interpolation weights for a given point.
Public function Const int Get the index into the flat TArray of positions given the (i,j,k) coordinates in the lattice.
Public function Const int

ControlPointIndexFromCoordinates ( int i,
int j,
int k
)

 Get the index into the flat TArray of positions given the (i,j,k) coordinates in the lattice.
Protected function Const FMatrix3d

CubicInterpolationJacobian ( const FEmbedding& VertexEmbedding,
const TArray< FVector3d >& LatticeControlPoints
)

  
Protected function Const FVector3d

ExtrapolatedLatticePosition ( const FVector3i& VirtualPointIndex,
const TArray< FVector3d >& LatticeControlPoints
)

 Compute the extrapolated position for a "virtual" lattice control point outside of the actual lattice.
Public function Const void

GenerateInitialLatticePositions ( TArray< FVector3d >& OutLatticePositions
)

 Return the set of lattice corner positions in undeformed state.
Public function Const void

GenerateLatticeEdges ( TArray< FVector2i >& OutLatticeEdges
)

 Return the lattice edges by index. The indices refer to the array of lattice positions returned by GenerateInitialLatticePositions.
Public function Const const FVector3d & 3D size of a lattice cell
Public function Const void

GetDeformedMeshVertexPositions ( const TArray< FVector3d >& LatticeControlPoints,
TArray< FVector3d >& OutVertexPositions,
ELatticeInterpolation Interpolation,
FLatticeExecutionInfo ExecutionInfo,
FProgressCancel* Progress
)

 Using the Lattice's current control point positions and the original embedding information, compute the deformed mesh vertex positions.
Public function Const const FVector3i & Number of lattice points in each dimension.
Public function Const const FAxisAlignedBox3d & Extents of the lattice before it is deformed.
Public function Const void

GetRotatedMeshVertexNormals ( const TArray< FVector3d >& LatticeControlPoints,
const TArray< FVector3f >& OriginalNormals,
TArray< FVector3f >& OutNormals,
ELatticeInterpolation Interpolation,
FLatticeExecutionInfo ExecutionInfo,
FProgressCancel* Progress
)

 Using the Lattice's current control point positions, the original embedding information, and the original normals, compute the new rotated normals
Public function Const void

GetRotatedOverlayNormals ( const TArray< FVector3d >& LatticeControlPoints,
const FDynamicMeshNormalOverlay* NormalOverlay,
TArray< FVector3f >& OutNormals,
ELatticeInterpolation Interpolation,
FLatticeExecutionInfo ExecutionInfo,
FProgressCancel* Progress
)

 Using the Lattice's current control point positions, the original embedding information, and the original normals contained in an overlay, compute the new rotated normals
Protected function Const void

GetValuePair ( int I,
int J,
int K,
FVector3d& A,
FVector3d& B,
const TArray< FVector3d >& LatticeControlPoints
)

 Helper for linear interpolation. Returns lattice points at (I,J,K) and (I+1,J,K).
Protected function Const FVector3d

InterpolatedPosition ( const FEmbedding& VertexEmbedding,
const TArray< FVector3d >& LatticeControlPoints
)

 Use the given cell index and weights to compute the interpolated position.
Protected function Const FVector3d

InterpolatedPositionCubic ( const FEmbedding& VertexEmbedding,
const TArray< FVector3d >& LatticeControlPoints
)

 Use the given cell index and weights to compute the interpolated position.
Protected function Const FMatrix3d

LinearInterpolationJacobian ( const FEmbedding& VertexEmbedding,
const TArray< FVector3d >& LatticeControlPoints
)

  

Classes

  Type Name Description
Public struct FEmbedding Linear interpolation information. There should be one of these per mesh vertex.  

Ask questions and help your peers Developer Forums

Write your own tutorials or read those from others Learning Library

On this page