35 lines
2.1 KiB
C++
35 lines
2.1 KiB
C++
// Copyright (c) 2012-2024 Wojciech Figat. All rights reserved.
|
|
|
|
#pragma once
|
|
|
|
#include "Engine/Core/Math/Vector3.h"
|
|
#include "Engine/Core/Math/Quaternion.h"
|
|
#include "Engine/Core/Math/Transform.h"
|
|
|
|
/// <summary>
|
|
/// The Inverse Kinematics (IK) utility library.
|
|
/// </summary>
|
|
class FLAXENGINE_API InverseKinematics
|
|
{
|
|
public:
|
|
/// <summary>
|
|
/// Rotates a node so it aims at a target. Solves the transformation (rotation) that needs to be applied to the node such that a provided forward vector (in node local space) aims at the target position (in skeleton model space).
|
|
/// </summary>
|
|
/// <param name="node">The node transformation (in model space).</param>
|
|
/// <param name="target">The target position to aim at (in model space).</param>
|
|
/// <param name="outNodeCorrection">The calculated output node correction (in model- space). It needs to be multiplied with node model space quaternion.</param>
|
|
static void SolveAimIK(const Transform& node, const Vector3& target, Quaternion& outNodeCorrection);
|
|
|
|
/// <summary>
|
|
/// Performs inverse kinematic on a three nodes chain (must be ancestors).
|
|
/// </summary>
|
|
/// <param name="rootNode">The start node transformation (in model space).</param>
|
|
/// <param name="jointNode">The middle node transformation (in model space).</param>
|
|
/// <param name="targetNode">The end node transformation (in model space).</param>
|
|
/// <param name="target">The target position of the end node to reach (in model space).</param>
|
|
/// <param name="jointTarget">The target position of the middle node to face into (in model space).</param>
|
|
/// <param name="allowStretching">True if allow bones stretching, otherwise bone lengths will be preserved when trying to reach the target.</param>
|
|
/// <param name="maxStretchScale">The maximum scale when stretching bones. Used only if allowStretching is true.</param>
|
|
static void SolveTwoBoneIK(Transform& rootNode, Transform& jointNode, Transform& targetNode, const Vector3& target, const Vector3& jointTarget, bool allowStretching = false, float maxStretchScale = 1.5f);
|
|
};
|