Draft: VRMC_springBone_limit

specification/VRMC_springBone_limit-1.0/README.md

@@ -0,0 +1,5 @@
+# VRMC_springBone_limit-1.0
+
+*Version 1.0-draft*
+
+TODO → [README.ja.md](README.ja.md)

specification/VRMC_springBone_limit-1.0/schema/VRMC_springBone_limit.coneLimit.schema.json

@@ -0,0 +1,27 @@
+{
+  "$schema": "http://json-schema.org/draft-04/schema",
+  "title": "ConeLimit",
+  "type": "object",
+  "description": "A limit that restricts the orientation of the spring in a cone shape.",
+  "allOf": [ { "$ref": "glTFProperty.schema.json" } ],
+  "properties": {
+    "angle": {
+      "type": "number",
+      "description": "The angle of the cone limit in radians. If the angle is set to π or greater, the angle will be interpreted as π by the implementation. When the angle is set to π, the cone shape becomes a sphere.",
+      "minimum": 0.0
+    },
+    "rotation": {
+      "type": "array",
+      "description": "The rotation from the default orientation of the cone limit. The rotation is represented as a quaternion (x, y, z, w), where w is the scalar.",
+      "items": {
+        "type": "number",
+        "minimum": -1.0,
+        "maximum": 1.0
+      },
+      "minItems": 4,
+      "maxItems": 4,
+      "default": [ 0.0, 0.0, 0.0, 1.0 ]
+    }
+  },
+  "required": [ "angle" ]
+}

specification/VRMC_springBone_limit-1.0/schema/VRMC_springBone_limit.hingeLimit.schema.json

@@ -0,0 +1,27 @@
+{
+  "$schema": "http://json-schema.org/draft-04/schema",
+  "title": "HingeLimit",
+  "type": "object",
+  "description": "A limit that restricts the orientation of the spring in a hinge shape.",
+  "allOf": [ { "$ref": "glTFProperty.schema.json" } ],
+  "properties": {
+    "angle": {
+      "type": "number",
+      "description": "The angle of the hinge limit in radians. If the angle is set to π or greater, the angle will be interpreted as π by the implementation. When the angle is set to π, the hinge shape becomes a full disc.",
+      "minimum": 0.0
+    },
+    "rotation": {
+      "type": "array",
+      "description": "The rotation from the default orientation of the hinge limit. The rotation is represented as a quaternion (x, y, z, w), where w is the scalar.",
+      "items": {
+        "type": "number",
+        "minimum": -1.0,
+        "maximum": 1.0
+      },
+      "minItems": 4,
+      "maxItems": 4,
+      "default": [ 0.0, 0.0, 0.0, 1.0 ]
+    }
+  },
+  "required": [ "angle" ]
+}

specification/VRMC_springBone_limit-1.0/schema/VRMC_springBone_limit.limit.schema.json

@@ -0,0 +1,25 @@
+{
+  "$schema": "http://json-schema.org/draft-04/schema",
+  "title": "Limit",
+  "type": "object",
+  "description": "Describes a limit apply to the spring. Either cone, hinge, or spherical must be present.",
+  "allOf": [ { "$ref": "glTFProperty.schema.json" } ],
+  "properties": {
+    "cone": {
+      "$ref": "VRMC_springBone_limit.coneLimit.schema.json"
+    },
+    "hinge": {
+      "$ref": "VRMC_springBone_limit.hingeLimit.schema.json"
+    },
+    "spherical": {
+      "$ref": "VRMC_springBone_limit.sphericalLimit.schema.json"
+    },
+    "extensions": { },
+    "extras": { }
+  },
+  "oneOf": [
+    { "required": [ "cone" ] },
+    { "required": [ "hinge" ] },
+    { "required": [ "spherical" ] }
+  ]
+}

specification/VRMC_springBone_limit-1.0/schema/VRMC_springBone_limit.schema.json

@@ -0,0 +1,19 @@
+{
+  "$schema": "http://json-schema.org/draft-04/schema",
+  "title": "VRMC_springBone_limit",
+  "type": "object",
+  "description": "An angle limit for VRMC_springBone.",
+  "allOf": [ { "$ref": "glTFProperty.schema.json" } ],
+  "properties": {
+    "specVersion": {
+      "type": "string",
+      "description": "Specification version of VRMC_springBone_limit."
+    },
+    "limit": {
+      "$ref": "VRMC_springBone_limit.limit.schema.json"
+    },
+    "extensions": { },
+    "extras": { }
+  },
+  "required": [ "specVersion", "limit" ]
+}

specification/VRMC_springBone_limit-1.0/schema/VRMC_springBone_limit.sphericalLimit.schema.json

@@ -0,0 +1,32 @@
+{
+  "$schema": "http://json-schema.org/draft-04/schema",
+  "title": "SphericalLimit",
+  "type": "object",
+  "description": "A limit that restricts the orientation of the spring in a spherical coordinate shape.",
+  "allOf": [ { "$ref": "glTFProperty.schema.json" } ],
+  "properties": {
+    "pitch": {
+      "type": "number",
+      "description": "The pitch angle of the spherical limit in radians. If the pitch angle is set to π or greater, the angle will be interpreted as π by the implementation.",
+      "minimum": 0.0
+    },
+    "yaw": {
+      "type": "number",
+      "description": "The yaw angle of the spherical limit in radians. If the yaw angle is set to π/2 or greater, the angle will be interpreted as π/2 by the implementation.",
+      "minimum": 0.0
+    },
+    "rotation": {
+      "type": "array",
+      "description": "The rotation from the default orientation of the spherical limit. The rotation is represented as a quaternion (x, y, z, w), where w is the scalar.",
+      "items": {
+        "type": "number",
+        "minimum": -1.0,
+        "maximum": 1.0
+      },
+      "minItems": 4,
+      "maxItems": 4,
+      "default": [ 0.0, 0.0, 0.0, 1.0 ]
+    }
+  },
+  "required": [ "pitch", "yaw" ]
+}