Initial Commit

2025-07-04 20:33:06 +03:00
commit 8f09347ae0
9219 changed files with 2447903 additions and 0 deletions
@@ -0,0 +1,113 @@
+/*
+ * 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 System.Collections.Generic;
+
+namespace Oculus.Interaction.PoseDetection
+{
+    public static class FingerFeatureProperties
+    {
+        public static readonly FeatureStateDescription[] CurlFeatureStates =
+        {
+            new FeatureStateDescription("0", "Open"),
+            new FeatureStateDescription("1", "Neutral"),
+            new FeatureStateDescription("2", "Closed"),
+        };
+        public static readonly FeatureStateDescription[] FlexionFeatureStates =
+        {
+            new FeatureStateDescription("3", "Open"),
+            new FeatureStateDescription("4", "Neutral"),
+            new FeatureStateDescription("5", "Closed"),
+        };
+        public static readonly FeatureStateDescription[] AbductionFeatureStates =
+        {
+            new FeatureStateDescription("6", "None"),
+            new FeatureStateDescription("7", "Closed"),
+            new FeatureStateDescription("8", "Open"),
+        };
+        public static readonly FeatureStateDescription[] OppositionFeatureStates =
+        {
+            new FeatureStateDescription("9", "Touching"),
+            new FeatureStateDescription("10", "Near"),
+            new FeatureStateDescription("11", "None"),
+        };
+
+        public static IReadOnlyDictionary<FingerFeature, FeatureDescription> FeatureDescriptions
+        {
+            get;
+        } =
+            new Dictionary<FingerFeature, FeatureDescription>
+            {
+                [FingerFeature.Curl] = new FeatureDescription(FeatureCurlShortHelpText,
+                    FeatureCurlDetailHelpText,
+                    180,
+                    260,
+                    CurlFeatureStates),
+                [FingerFeature.Flexion] = new FeatureDescription(
+                    FeatureFlexionShortHelpText,
+                    FeatureFlexionDetailHelpText,
+                    180,
+                    260,
+                    FlexionFeatureStates),
+                [FingerFeature.Abduction] = new FeatureDescription(
+                    FeatureAbductionShortHelpText,
+                    FeatureAbductionDetailHelpText,
+                    8,
+                    90,
+                    AbductionFeatureStates),
+                [FingerFeature.Opposition] = new FeatureDescription(
+                    FeatureOppositionShortHelpText,
+                    FeatureOppositionDetailHelpText,
+                    0,
+                    0.2f,
+                    OppositionFeatureStates)
+            };
+
+        public const string FeatureCurlShortHelpText =
+                    "Convex angle (in degrees) representing the top 2 joints of the fingers. Angle increases as finger curl becomes closed.";
+        public const string FeatureCurlDetailHelpText =
+                    "Calculated from the average of the convex angles formed by the 2 bones connected to Joint 2, and 2 bones connected to Joint 3.\n" +
+                    "Values above 180 Positive show a curled state, while values below 180 represent hyper-extension.";
+        public const string FeatureFlexionShortHelpText =
+                    "Convex angle (in degrees) of joint 1 of the finger. Angle increases as finger flexion becomes closed.";
+        public const string FeatureFlexionDetailHelpText =
+                    "Calculated from the angle between the bones connected to finger Joint 1 around the Z axis of the joint.\n" +
+                    "For fingers, joint 1 is commonly known as the 'Knuckle'; but for the thumb it is alongside the wrist.\n" +
+                    "Values above 180 Positive show a curled state, while values below 180 represent hyper-extension." +
+                    "upwards from the palm.";
+        public const string FeatureAbductionShortHelpText =
+                    "Angle (in degrees) between the given finger, and the next finger towards the pinkie.";
+        public const string FeatureAbductionDetailHelpText =
+                    "Zero value implies that the two fingers are parallel.\n" +
+                    "Positive angles indicate that the fingertips are spread apart.\n" +
+                    "Small negative angles are possible, and indicate that the finger is pressed up against the next finger.";
+        public const string FeatureOppositionShortHelpText =
+            "Distance between the tip of the given finger and the tip of the thumb.\n" +
+                    "Calculated tracking space, with a 1.0 hand scale.";
+        public const string FeatureOppositionDetailHelpText =
+                    "Positive values indicate that the fingertips are spread apart.\n" +
+                    "Negative values are not possible.";
+
+        public const string FeatureStateThresholdMidpointHelpText = "The angle at which a state will transition from A > B (or B > A)";
+        public const string FeatureStateThresholdWidthHelpText =
+            "How far the angle must exceed the midpoint until the transition can occur. " +
+            "This is to prevent rapid flickering at transition edges.";
+    }
+}