1. Epic GamesDeveloper
  3. TFrame3

TFrame3

[TFrame3](API\Runtime\GeometryCore\TFrame3) is an object that represents an oriented 3D coordinate frame, ie orthogonal X/Y/Z axes at a point in space.

API > API/Runtime > API/Runtime/GeometryCore

References

   
Module GeometryCore
Header /Engine/Source/Runtime/GeometryCore/Public/FrameTypes.h
Include #include "FrameTypes.h"

Syntax

template<typename RealType>  
struct TFrame3

Remarks

TFrame3 is an object that represents an oriented 3D coordinate frame, ie orthogonal X/Y/Z axes at a point in space. One can think of this Frame as a local coordinate space measured along these axes. Functions are provided to map geometric objects to/from the Frame coordinate space.

Internally the representation is the same as an FTransform, except a Frame has no Scale.

Variables

  Type Name Description
Public variable TVector< RealType > Origin Origin of the frame
Public variable TQuaternion< RealType > Rotation Rotation of the frame. Think of this as the rotation of the unit X/Y/Z axes to the 3D frame axes.

Constructors

  Type Name Description
Public function  

TFrame3 ()

 Construct a frame positioned at (0,0,0) aligned to the unit axes
Public function  

TFrame3 ( const TVector< RealType >& OriginIn
)

 Construct a frame at the given Origin aligned to the unit axes
Public function  

TFrame3 ( const FTransform& Transform
)

 Construct a Frame from an FTransform
Public function  

TFrame3 ( const FPlane& Plane
)

 Construct a Frame from an FPlane
Public function  

TFrame3 ( const TFrame3< RealType2 >& OtherFrame
)

 Convert between TFrame of different types
Public function  

TFrame3 ( const TVector< RealType >& OriginIn,
const TQuaternion< RealType > RotationIn
)

 Construct a Frame from the given Origin and Rotation
Public function  

TFrame3 ( const TVector< RealType >& OriginIn,
const TVector< RealType >& SetZ
)

 Construct a frame with the Z axis aligned to a target axis
Public function  

TFrame3 ( const FVector& OriginIn,
const FQuat& RotationIn
)

 Construct a Frame from an FVector and FQuat
Public function  

TFrame3 ( const TVector< RealType >& OriginIn,
const TVector< RealType >& X,
const TVector< RealType >& Y,
const TVector< RealType >& Z
)

 Construct Frame from X/Y/Z axis vectors. Vectors must be mutually orthogonal.

Functions

  Type Name Description
Public function void

AlignAxis ( int AxisIndex,
const TVector< RealType >& ToDirection
)

 Align an axis of this frame with a target direction
Public function void

ConstrainedAlignAxis ( int AxisIndex,
const TVector< RealType >& ToDirection,
const TVector< RealType >& AroundVector
)

 Compute rotation around vector that best-aligns axis of frame with target direction
Public function void

ConstrainedAlignPerpAxes ( int PerpAxis1,
int PerpAxis2,
int NormalAxis,
const TVector< RealType >& UpAxis,
const TVector< RealType >& FallbackAxis,
RealType UpDotTolerance
)

 Compute rotation around NormalAxis that best-aligns one of the other two frame axes with either given UpAxis or FallbackAxis (FallbackAxis is required if Dot(NormalAxis,UpAxis) > UpDotTolerance, ie if the Normal and Up directions are too closely aligned. Basically this divides direction-sphere into three regions - polar caps with size defined by UpDotTolerance, and a wide equator band covering the rest. When crossing between these regions the alignment has a discontinuity. It is impossible to avoid this discontinuity because it is impossible to comb a sphere.
Public function Const TFrame3< RealType >

FromFrame ( const TFrame3< RealType >& Frame
)

  
Public function Const TRay< RealType >

FromFrame ( const TRay< RealType >& Ray
)

  
Public function Const TQuaternion< RealType >

FromFrame ( const TQuaternion< RealType >& Quat
)

  
Public function Const TVector< RealType >

FromFramePoint ( const TVector< RealType >& Point
)

  
Public function Const TVector< RealType >

FromFrameVector ( const TVector< RealType >& Vector
)

  
Public function Const TVector< RealType >

FromPlaneUV ( const TVector2< RealType >& PosUV,
int PlaneNormalAxis
)

 Map a point from local UV plane coordinates to the corresponding 3D point in one of the planes of the frame
Public function Const void

GetAxes ( TVector< RealType >& X,
TVector< RealType >& Y,
TVector< RealType >& Z
)

  
Public function Const TVector< RealType >

GetAxis ( int AxisIndex
)

  
Public function Const TVector< RealType >

PointAt ( RealType X,
RealType Y,
RealType Z
)

  
Public function Const TVector< RealType >

PointAt ( const TVector< RealType >& Point
)

  
Public function Const bool

RayPlaneIntersection ( const TVector< RealType >& RayOrigin,
const TVector< RealType >& RayDirection,
int PlaneNormalAxis,
UE::Math::TVector< RealType >& HitPointOut
)

 Compute intersection of ray with plane defined by frame origin and axis as normal
Public function void

Rotate ( const TQuaternion< RealType >& Quat
)

 Rotate this frame by given quaternion
Public function Const FPlane  
Public function Const TRay< RealType >

ToFrame ( const TRay< RealType >& Ray
)

  
Public function Const TFrame3< RealType >

ToFrame ( const TFrame3< RealType >& Frame
)

  
Public function Const TQuaternion< RealType >

ToFrame ( const TQuaternion< RealType >& Quat
)

  
Public function Const TVector< RealType >

ToFramePoint ( const TVector< RealType >& Point
)

  
Public function Const TVector< RealType >

ToFrameVector ( const TVector< RealType >& Vector
)

  
Public function Const FTransform  
Public function Const FTransform  
Public function Const TTransformSRT3< RealType >  
Public function Const TVector< RealType >

ToPlane ( const TVector< RealType >& Pos,
int PlaneNormalAxis
)

 Project a point onto one of the planes of the frame
Public function Const TVector2< RealType >

ToPlaneUV ( const TVector< RealType >& Pos,
int PlaneNormalAxis
)

 Project 3D point into plane and convert to UV coordinates in that plane
Public function Const TTransformSRT3< RealType >  
Public function void

Transform ( const TTransformSRT3< RealType >& XForm
)

 Transform this frame by the given transform.
Public function void

Transform ( const FTransform& XForm
)

 Transform this frame by the given transform.
Public function Const TVector< RealType >

X ()

  
Public function Const TVector< RealType >

Y ()

  
Public function Const TVector< RealType >

Z ()

  

Ask questions and help your peers Developer Forums

Write your own tutorials or read those from others Learning Library

On this page