Updated HelpURLs to new Doxygen documentation

This commit is contained in:
Pascal Serrarens 2022-01-18 17:18:15 +01:00
parent 58d9b0e5ca
commit 650b3c965f
15 changed files with 69 additions and 65 deletions

View File

@ -147,9 +147,9 @@ namespace Passer.Humanoid {
}
public virtual void ShowSensor(HumanoidTarget target, bool shown) { }
//}
//}
//public class HumanoidSensor : UnitySensor {
//public class HumanoidSensor : UnitySensor {
protected virtual void UpdateTarget(HumanoidTarget.TargetTransform target, Transform sensorTransform) {
if (target.transform == null || sensorTransform == null)
@ -176,7 +176,6 @@ namespace Passer.Humanoid {
protected Vector3 GetTargetPosition(Transform sensorTransform) {
Vector3 targetPosition = sensorTransform.position + sensorTransform.rotation * sensor2TargetRotation * sensor2TargetPosition;
Debug.DrawLine(targetPosition, sensorTransform.position, Color.magenta);
return targetPosition;
}

View File

@ -104,8 +104,8 @@ namespace Passer.Humanoid {
/// * \ref HumanoidControl::scaling "Scaling"
/// * \ref HumanoidControl::dontDestroyOnLoad "Don't Destroy on Load"
/// * \ref HumanoidControl::disconnectInstances "Disconnect Instances"
[HelpURL("https://passervr.com/documentation/humanoid-control/humanoid-control-script/")]
public class HumanoidControl : MonoBehaviour /*: PawnControl*/ {
[HelpURL("https://passervr.com/apis/HumanoidControl/Unity/class_passer_1_1_humanoid_1_1_humanoid_control.html")]
public class HumanoidControl : MonoBehaviour {
/// <summary>The path at which the HumanoidControl script is found</summary>
public string path;
@ -228,7 +228,7 @@ namespace Passer.Humanoid {
// Experimental
public string remoteTrackerIpAddress;
#endregion
#endregion
/// <summary>
/// The local Id of this humanoid
@ -239,7 +239,7 @@ namespace Passer.Humanoid {
public Cerebellum.Cerebellum cerebellum;
#endif
#region Settings
#region Settings
/// <summary>If true, real world objects like controllers and cameras are shown in the scene</summary>
public bool showRealObjects = true;
@ -310,9 +310,9 @@ namespace Passer.Humanoid {
/// </summary>
public bool disconnectInstances = false;
#endregion
#endregion
#region Init
#region Init
protected void Awake() {
if (dontDestroyOnLoad)
@ -352,9 +352,9 @@ namespace Passer.Humanoid {
StartSensors();
}
#endregion
#endregion
#region Avatar
#region Avatar
private float GetAvatarNeckHeight() {
if (avatarRig == null)
@ -635,9 +635,9 @@ namespace Passer.Humanoid {
return 0;
}
#endregion
#endregion
#region Targets
#region Targets
protected void NewTargetComponents() {
#if pCEREBELLUM
if (cerebellum == null)
@ -943,9 +943,9 @@ namespace Passer.Humanoid {
};
}
#endregion
#endregion
#region Trackers
#region Trackers
/// <summary>Use game controller input</summary>
public bool gameControllerEnabled = true;
@ -992,10 +992,10 @@ namespace Passer.Humanoid {
//#if hSTEAMVR && UNITY_STANDALONE_WIN
// public SteamVRTracker steamVR = new SteamVRTracker();
//#endif
//#if hOCULUS && (UNITY_STANDALONE_WIN || UNITY_ANDROID)
// /// <summary>The Oculus tracker</summary>
// public OculusTracker oculus = new OculusTracker();
//#endif
//#if hOCULUS && (UNITY_STANDALONE_WIN || UNITY_ANDROID)
// /// <summary>The Oculus tracker</summary>
// public OculusTracker oculus = new OculusTracker();
//#endif
/// <summary>The Windows Mixed Reality tracker</summary>
#if hWINDOWSMR && UNITY_WSA_10_0
public WindowsMRTracker mixedReality = new WindowsMRTracker();
@ -1291,9 +1291,9 @@ namespace Passer.Humanoid {
tracker.AdjustTracking(translation, rotation);
}
#endregion
#endregion
#region Configuration
#region Configuration
/// <summary>
/// Scans the humanoid to retrieve all bones
/// </summary>
@ -1306,9 +1306,9 @@ namespace Passer.Humanoid {
leftFootTarget.RetrieveBones();
rightFootTarget.RetrieveBones();
}
#endregion
#endregion
#region Update
#region Update
protected void Update() {
Controllers.Clear();
@ -1344,9 +1344,9 @@ namespace Passer.Humanoid {
Controllers.EndFrame();
}
#endregion
#endregion
#region Stop
#region Stop
public void OnApplicationQuit() {
#if hLEAP
leapTracker.StopTracker();
@ -1370,11 +1370,11 @@ namespace Passer.Humanoid {
optitrack.StopTracker();
#endif
}
#endregion
#endregion
#region Destroy
#region Destroy
#endregion
#endregion
public Vector3 up {
get {
@ -1419,7 +1419,7 @@ namespace Passer.Humanoid {
}
}
#region Calibration
#region Calibration
public void SetStartPosition() {
}
@ -1448,9 +1448,9 @@ namespace Passer.Humanoid {
}
}
#endregion
#endregion
#region Pose
#region Pose
protected virtual void UpdatePose() {
if (pose != null) {
@ -1459,7 +1459,7 @@ namespace Passer.Humanoid {
}
}
#region Pose Event
#region Pose Event
public delegate void OnHumanoidPose(HumanoidPose pose);
public event OnHumanoidPose onHumanoidPose;
@ -1520,11 +1520,11 @@ namespace Passer.Humanoid {
}
}
#endregion
#endregion
#endregion
#endregion
#region Movement
#region Movement
/// <summary>
/// maximum forward speed in units(meters)/second
@ -1569,7 +1569,7 @@ namespace Passer.Humanoid {
protected Vector3 inputMovement = Vector3.zero;
#region Input/API
#region Input/API
/// <summary>
/// maximum forward speed in units(meters)/second
@ -1781,9 +1781,9 @@ namespace Passer.Humanoid {
}
#endregion
#endregion
#region Checks
#region Checks
[HideInInspector]
public Vector3 targetVelocity;
@ -1896,9 +1896,9 @@ namespace Passer.Humanoid {
return distance * elapsedTime * elapsedTime + start;
}
#endregion
#endregion
#region Collisions
#region Collisions
public bool triggerEntered;
public bool collided;
@ -2071,9 +2071,9 @@ namespace Passer.Humanoid {
);
}
#endregion
#endregion
#region Ground
#region Ground
/// <summary>
/// The ground Transform on which the pawn is standing
@ -2221,9 +2221,9 @@ namespace Passer.Humanoid {
lastGroundAngle = ground.eulerAngles.y;
}
#endregion
#endregion
#region Body Pull
#region Body Pull
protected virtual void CheckBodyPull() {
if (!bodyPull)
@ -2262,7 +2262,7 @@ namespace Passer.Humanoid {
transform.Translate(translation, Space.World);
}
#endregion
#endregion
[HideInInspector]
private float lastTime;
@ -2301,7 +2301,7 @@ namespace Passer.Humanoid {
lastHeadDirection = headTarget.neck.target.transform.eulerAngles.y;
}
#region Animation
#region Animation
public string animatorParameterForward;
public string animatorParameterSideward;
public string animatorParameterRotation;
@ -2381,7 +2381,7 @@ namespace Passer.Humanoid {
targetsRig.SetTrigger(parameterName);
}
#endregion
#endregion
[HideInInspector]
private float lastLocalHipY;
@ -2402,7 +2402,7 @@ namespace Passer.Humanoid {
lastLocalHipY = localHipY;
}
#endregion Movement
#endregion Movement
/// <summary>Gets the Real World GameObject for this Humanoid</summary>
/// <param name="transform">The root transform of the humanoid</param>
@ -2470,7 +2470,7 @@ namespace Passer.Humanoid {
// return footBase;
//}
#region Networking
#region Networking
/// <summary>Is true when this is a remote pawn</summary>
/// Remote pawns are not controlled locally, but are controlled from another computer.
@ -2483,9 +2483,9 @@ namespace Passer.Humanoid {
/// <summary>The local Id of this humanoid</summary>
public int id = -1;
#endregion
#endregion
#region Humanoid store
#region Humanoid store
private static HumanoidControl[] _allHumanoids = new HumanoidControl[0];
public static HumanoidControl[] allHumanoids {
@ -2574,6 +2574,8 @@ namespace Passer.Humanoid {
screenPosition.y > 0 && screenPosition.y < camera.pixelHeight);
}
#endregion
#endregion
}
}
}

View File

@ -41,14 +41,14 @@ namespace Passer.Humanoid {
///
/// Settings
/// ========
/// \ref FootTarget::rotationSpeedLimitation "Rotation Speed Limitation"
/// \ref FootTarget::slidePrevention "Slide Prevention"
/// * \ref FootTarget::rotationSpeedLimitation "Rotation Speed Limitation"
/// * \ref FootTarget::slidePrevention "Slide Prevention"
///
/// Events
/// ======
/// * \ref FootTarget::groundEvent "Ground Event"
///
[HelpURLAttribute("https://passervr.com/documentation/humanoid-control/foot-target/")]
[HelpURL("https://passervr.com/apis/HumanoidControl/Unity/class_passer_1_1_humanoid_1_1_foot_target.html")]
public class FootTarget : HumanoidTarget {
public bool isLeft;
public Side side;

View File

@ -100,7 +100,7 @@ namespace Passer.Humanoid {
/// * Add \ref Passer::Teleporter "Teleporter": Adds a preconfigured interaction pointer
/// to the hand target which can teleport the avatar by pointing to new positions.
[System.Serializable]
[HelpURLAttribute("https://passervr.com/documentation/humanoid-control/hand-target/")]
[HelpURL("https://passervr.com/apis/HumanoidControl/Unity/class_passer_1_1_humanoid_1_1_hand_target.html")]
public partial class HandTarget : HumanoidTarget {
public HandTarget() {
shoulder = new TargetedShoulderBone(this);

View File

@ -61,7 +61,7 @@ namespace Passer.Humanoid {
/// <a href="http://passervr.com/documentation/interaction-eventsystem-and-ui/">Interaction, Event System and UI</a>.
/// * Add \ref Passer::Teleporter "Teleporter": Adds a preconfigured gaze interaction pointer
/// to the head target which can teleport the avatar by pointing to new positions.
[HelpURL("https://passervr.com/documentation/humanoid-control/head-target/")]
[HelpURL("https://passervr.com/apis/HumanoidControl/Unity/class_passer_1_1_humanoid_1_1_head_target.html")]
public class HeadTarget : HumanoidTarget {
public HeadTarget() {

View File

@ -38,7 +38,7 @@ namespace Passer.Humanoid {
/// ========
/// \ref HipsTarget::bodyRotation "Body Rotation"
///
[HelpURLAttribute("https://passervr.com/documentation/humanoid-control/hips-target/")]
[HelpURL("https://passervr.com/apis/HumanoidControl/Unity/class_passer_1_1_humanoid_1_1_hips_target.html")]
public partial class HipsTarget : HumanoidTarget {
public HipsTarget() {

View File

@ -42,7 +42,7 @@ namespace Passer.Humanoid {
///
/// \image AvatarManagerControllerInput.png
///
[HelpURLAttribute("https://passervr.com/documentation/humanoid-control/avatar-manager/")]
[HelpURL("https://passervr.com/apis/HumanoidControl/Unity/class_passer_1_1_humanoid_1_1_avatar_manager.html")]
public class AvatarManager : MonoBehaviour {
/// <summary>The index of the current avatar in the list</summary>

View File

@ -15,6 +15,7 @@ namespace Passer {
/// * %Is unique, see Possession::isUnique
///
/// \version 4
[HelpURL("https://passervr.com/apis/HumanoidControl/Unity/class_passer_1_1_possessable.html")]
public class Possessable : MonoBehaviour {
/// <summary>

View File

@ -31,6 +31,7 @@ namespace Passer {
/// Example sites can be found in Assets/Passer/Sites/
///
/// \version 4.0 and higher
[HelpURL("https://passervr.com/apis/HumanoidControl/Unity/class_passer_1_1_site.html")]
[RequireComponent(typeof(HumanoidSpawnPoint))]
public class Site : MonoBehaviour {

View File

@ -20,6 +20,7 @@ namespace Passer {
/// (e.g. SteamVR or Oculus Touch controllers).
/// For game controllers like the Xbox controller, this corresponds to the left and right side of the gamepad.
/// Event input is using an EventHandler to define its behaviour.
[HelpURL("https://passervr.com/apis/HumanoidControl/Unity/class_passer_1_1_controller_input.html")]
public class ControllerInput : MonoBehaviour {
public enum SideButton {

View File

@ -17,7 +17,7 @@ namespace Passer {
/// The easiest way to turn a single-user scene in a multi-user environment is to add the
/// NetworkingStarter prefab to the scene. You can find this in the Humanoid->Prefabs->Networking folder.
[System.Serializable]
[HelpURLAttribute("https://passervr.com/documentation/humanoid-control/networking-support/")]
[HelpURL("https://passervr.com/apis/HumanoidControl/Unity/class_passer_1_1_networking_starter.html")]
#if hNW_PHOTON
#if hPHOTON2
public class NetworkingStarter : Photon.Pun.MonoBehaviourPunCallbacks

View File

@ -21,6 +21,7 @@ namespace Passer {
/// - Value Change Event, see Counter::counterEvent
///
/// \version 4.0 and higher
[HelpURL("https://passervr.com/apis/HumanoidControl/Unity/class_passer_1_1_counter.html")]
public class Counter : MonoBehaviour {
#region Properties

View File

@ -40,9 +40,7 @@ namespace Passer {
/// The difference is that empty entries do not override the ControllerInput configuration.
/// When the handle is released by the hand,
/// the ControllerInput is restored to the original configuration.
///
[HelpURL("https://passervr.com/documentation/humanoid-control/grabbing-objects/handle/")]
[HelpURL("https://passervr.com/apis/HumanoidControl/Unity/class_passer_1_1_handle.html")]
public class Handle : MonoBehaviour {
/// <summary>The way in which the hand can grab the handle</summary>

View File

@ -19,6 +19,7 @@ namespace Passer.Humanoid {
/// In the scene view, the capsule is visualized as an orange cylinder when the spawn point is selected:
///
/// \image html HumanoidSpawnPointGizmo.png
[HelpURL("https://passervr.com/apis/HumanoidControl/Unity/class_passer_1_1_humanoid_1_1_humanoid_spawn_point.html")]
public class HumanoidSpawnPoint : SpawnPoint {
/// <summary>

View File

@ -122,7 +122,7 @@ namespace Passer {
/// This joint is implemented using a Configurable Joint
/// such that it will follow the Handles Transform as closely as possible.
/// When the Handle is released, the joint is destroyed again.
///
[HelpURL("https://passervr.com/apis/HumanoidControl/Unity/class_passer_1_1_socket.html")]
public class Socket : MonoBehaviour {
protected static void DebugLog(string s) {