// 1 - |dot| ≈ 0 when quats represent the same rotation (handles

// sign flip with the absolute value).

return (1.0f - std::fabs(a.Dot(b))) <= eps;

const Ogre::Vector3& beforePos,

const Ogre::Quaternion& beforeOrient,

const Ogre::Vector3& beforeScale,

bool hasActiveAnim,

bool autoKeyOn,

Ogre::Entity* entityForUpdate)

{

if (!bone) return Result::NoOp;

// Tolerant comparison — drag math can accumulate sub-microsecond

// float noise that would otherwise mis-fire Commit on a press/

// release with no intended motion.

const bool changed = !nearlyEqual(bone->getPosition(), beforePos, kPosEpsilon)

|| !nearlyEqual(bone->getOrientation(), beforeOrient, kQuatDotEps)

|| !nearlyEqual(bone->getScale(), beforeScale, kScaleEpsilon);

if (!changed) {

// Even "no change" should release manual control if it was set

// during the (zero-delta) drag.

bone->setManuallyControlled(false);

return Result::NoOp;

}

if (autoKeyOn && hasActiveAnim) {

// Caller writes the keyframe (via AnimationControlController) and

// pushes BoneTransformCommand. We just unfreeze the bone so the

// curve drives playback through the new key.

bone->setManuallyControlled(false);

return Result::Commit;

}

if (hasActiveAnim) {

// Preview only: revert bone to its pre-drag local TRS so playback

// is unaffected. Don't call setInitialState — the curve stores

// deltas relative to initial; changing initial would double-apply

// the curve delta on next sample.

bone->setPosition(beforePos);

bone->setOrientation(beforeOrient);

bone->setScale(beforeScale);

bone->setManuallyControlled(false);

bone->needUpdate(true);

if (entityForUpdate) entityForUpdate->_updateAnimation();

return Result::Revert;

}

// No active animation: T-pose / bind-pose authoring. The dragged

// local TRS becomes the new bind pose.

bone->setInitialState();

bone->setManuallyControlled(false);

return Result::CommitBind;