148 lines
4.6 KiB
C#
148 lines
4.6 KiB
C#
/*
|
|
* Copyright (c) Meta Platforms, Inc. and affiliates.
|
|
* All rights reserved.
|
|
*
|
|
* Licensed under the Oculus SDK License Agreement (the "License");
|
|
* you may not use the Oculus SDK except in compliance with the License,
|
|
* which is provided at the time of installation or download, or which
|
|
* otherwise accompanies this software in either electronic or hard copy form.
|
|
*
|
|
* You may obtain a copy of the License at
|
|
*
|
|
* https://developer.oculus.com/licenses/oculussdk/
|
|
*
|
|
* Unless required by applicable law or agreed to in writing, the Oculus SDK
|
|
* distributed under the License is distributed on an "AS IS" BASIS,
|
|
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
* See the License for the specific language governing permissions and
|
|
* limitations under the License.
|
|
*/
|
|
|
|
using UnityEngine;
|
|
|
|
namespace Oculus.Interaction.HandGrab.Visuals
|
|
{
|
|
/// <summary>
|
|
/// A static (non-user controlled) representation of a hand. This script is used
|
|
/// to be able to manually visualize hand grab poses.
|
|
/// </summary>
|
|
[RequireComponent(typeof(HandPuppet))]
|
|
public class HandGhost : MonoBehaviour
|
|
{
|
|
/// <summary>
|
|
/// The puppet is used to actually move the representation of the hand.
|
|
/// </summary>
|
|
[SerializeField]
|
|
private HandPuppet _puppet;
|
|
|
|
/// <summary>
|
|
/// The actual root of the hand hierarchy
|
|
/// </summary>
|
|
[SerializeField, Optional]
|
|
private Transform _root;
|
|
public Transform Root => _root;
|
|
|
|
/// <summary>
|
|
/// The HandGrab point can be set so the ghost automatically
|
|
/// adopts the desired pose of said point.
|
|
/// </summary>
|
|
[SerializeField, Optional]
|
|
[UnityEngine.Serialization.FormerlySerializedAs("_handGrabPoint")]
|
|
private HandGrabPose _handGrabPose;
|
|
|
|
#region editor events
|
|
protected virtual void Reset()
|
|
{
|
|
_puppet = this.GetComponent<HandPuppet>();
|
|
_handGrabPose = this.GetComponentInParent<HandGrabPose>();
|
|
}
|
|
|
|
protected virtual void OnValidate()
|
|
{
|
|
if (_puppet == null)
|
|
{
|
|
return;
|
|
}
|
|
|
|
if (_handGrabPose == null)
|
|
{
|
|
HandGrabPose point = this.GetComponentInParent<HandGrabPose>();
|
|
if (point != null)
|
|
{
|
|
SetPose(point);
|
|
}
|
|
}
|
|
else if (_handGrabPose != null)
|
|
{
|
|
SetPose(_handGrabPose);
|
|
}
|
|
}
|
|
#endregion
|
|
|
|
protected virtual void Start()
|
|
{
|
|
this.AssertField(_puppet, nameof(_puppet));
|
|
if (_root == null)
|
|
{
|
|
_root = this.transform;
|
|
}
|
|
}
|
|
|
|
/// <summary>
|
|
/// Relay to the Puppet to set the ghost hand to the desired static pose
|
|
/// </summary>
|
|
/// <param name="handGrabPose">The point to read the HandPose from</param>
|
|
public void SetPose(HandGrabPose handGrabPose)
|
|
{
|
|
HandPose userPose = handGrabPose.HandPose;
|
|
if (userPose == null)
|
|
{
|
|
return;
|
|
}
|
|
|
|
_puppet.SetJointRotations(userPose.JointRotations);
|
|
SetRootPose(handGrabPose.RelativePose, handGrabPose.RelativeTo);
|
|
}
|
|
|
|
public void SetPose(HandPose userPose, Pose rootPose)
|
|
{
|
|
_puppet.SetJointRotations(userPose.JointRotations);
|
|
_puppet.SetRootPose(rootPose);
|
|
}
|
|
|
|
/// <summary>
|
|
/// Moves the underlying puppet so the wrist point aligns with the given parameters
|
|
/// </summary>
|
|
/// <param name="rootPose">The relative wrist pose to align the hand to</param>
|
|
/// <param name="relativeTo">The object to use as anchor</param>
|
|
public void SetRootPose(Pose rootPose, Transform relativeTo)
|
|
{
|
|
Pose pose = rootPose;
|
|
if (relativeTo != null)
|
|
{
|
|
pose = PoseUtils.GlobalPoseScaled(relativeTo, rootPose);
|
|
}
|
|
_puppet.SetRootPose(pose);
|
|
}
|
|
|
|
#region Inject
|
|
public void InjectAllHandGhost(HandPuppet puppet)
|
|
{
|
|
InjectHandPuppet(puppet);
|
|
}
|
|
public void InjectHandPuppet(HandPuppet puppet)
|
|
{
|
|
_puppet = puppet;
|
|
}
|
|
public void InjectOptionalHandGrabPose(HandGrabPose handGrabPose)
|
|
{
|
|
_handGrabPose = handGrabPose;
|
|
}
|
|
public void InjectOptionalRoot(Transform root)
|
|
{
|
|
_root = root;
|
|
}
|
|
#endregion
|
|
}
|
|
}
|