diff --git a/specification/VRMC_springBone_limit-1.0/README.ja.md b/specification/VRMC_springBone_limit-1.0/README.ja.md new file mode 100644 index 0000000..b85e238 --- /dev/null +++ b/specification/VRMC_springBone_limit-1.0/README.ja.md @@ -0,0 +1,512 @@ +# VRMC_springBone_limit-1.0 + +*Version 1.0-draft* + + + + +- [Contributors](#contributors) +- [Status](#status) +- [Dependencies](#dependencies) +- [Overview](#overview) + - [Limits](#limits) + - [Cone Limit](#cone-limit) + - [Hinge Limit](#hinge-limit) + - [Spherical Limit](#spherical-limit) + - [Rotation](#rotation) + - [Limit Application Order](#limit-application-order) +- [glTF Schema Updates](#gltf-schema-updates) + - [Extending Springs](#extending-springs) + - [VRMC_springBone_limit](#vrmc_springbone_limit) + - [Properties](#properties) + - [JSON Schema](#json-schema) + - [VRMC_springBone_limit.specVersion ✅](#vrmc_springbone_limitspecversion-) + - [VRMC_springBone_limit.limit ✅](#vrmc_springbone_limitlimit-) + - [Limit](#limit) + - [Properties](#properties-1) + - [JSON Schema](#json-schema-1) + - [Limit.cone](#limitcone) + - [Limit.hinge](#limithinge) + - [Limit.spherical](#limitspherical) + - [ConeLimit](#conelimit) + - [Properties](#properties-2) + - [JSON Schema](#json-schema-2) + - [ConeLimit.angle ✅](#conelimitangle-) + - [ConeLimit.rotation](#conelimitrotation) + - [HingeLimit](#hingelimit) + - [Properties](#properties-3) + - [JSON Schema](#json-schema-3) + - [HingeLimit.angle ✅](#hingelimitangle-) + - [HingeLimit.rotation](#hingelimitrotation) + - [SphericalLimit](#sphericallimit) + - [Properties](#properties-4) + - [JSON Schema](#json-schema-4) + - [SphericalLimit.pitch ✅](#sphericallimitpitch-) + - [SphericalLimit.yaw ✅](#sphericallimityaw-) + - [SphericalLimit.rotation](#sphericallimitrotation) +- [Appendix: Reference Implementations](#appendix-reference-implementations) + - [Overview](#overview-1) + - [Rotation](#rotation-1) + - [ConeLimit](#conelimit-1) + - [HingeLimit](#hingelimit-1) + - [SphericalLimit](#sphericallimit-1) + + + +## Contributors + +- 0b5vr + +## Status + +Draft + +## Dependencies + +glTF 2.0仕様に向けて策定されています。 + +本仕様は [`VRMC_springBone`](https://github.com/vrm-c/vrm-specification/blob/master/specification/VRMC_springBone-1.0/README.ja.md) に依存します。 + +## Overview + +`VRMC_springBone_limit` は、`VRMC_springBone` によって制御されるスプリングの移動範囲を制限するglTF拡張です。 +本拡張は、コーンリミット・ヒンジリミット・球面リミットを定義します。 + +### Limits + +本拡張によって定義されるリミットは、コーンリミット・ヒンジリミット・球面リミットの3種類です。 + +各リミットについて、参考実装を[Appendix: Reference Implementations](#appendix-reference-implementations)に示します。 + +#### Cone Limit + +コーンリミットは、スプリングの移動範囲をコーン状に制限します。 + +コーンリミットは、コーンの広がりを表す角度・コーンの向きを表す回転で定義されます。 + +コーンリミットが定義されたスプリングは、HeadからTailに向かう方向を基準として、コーンの角度として指定した角度よりも傾くことがないように回転が制限されます。 + +リミットの回転を指定しない場合、コーンはHeadからTailに向かう方向に向かって広がるように定義されます。 + +![コーンリミットの図](./figures/cone-limit.png) + +#### Hinge Limit + +ヒンジリミットは、スプリングの移動範囲をヒンジ状に制限します。 + +ヒンジリミットは、ヒンジの広がりを表す角度・ヒンジの向きを表す回転で定義されます。 + +ヒンジリミットが定義されたスプリングは、HeadからTailに向かう方向を基準として、ヒンジの角度として指定した角度よりも傾くことがないよう、またヒンジが定義した回転軸以外で回転することがないように回転が制限されます。 + +リミットの回転を指定しない場合、オブジェクトのy軸正方向に広がり、x軸周りの回転を許容するような形状を持つヒンジを、HeadからTailに向かう方向にヒンジが広がるよう最短経路で回転させた状態で定義します。 + +![ヒンジリミットの図](./figures/hinge-limit.png) + +#### Spherical Limit + +球面リミットは、スプリングの移動範囲を球面状に制限します。 + +球面リミットは、2つの角度Pitch・Yawと、球面の向きを表す回転で定義されます。 + +球面リミットが定義されたスプリングは、HeadからTailに向かう方向を基準として、パラメータとして設定したPitch・Yawよりも傾くことがないように回転が制限されます。 + +リミットの回転を指定しない場合、オブジェクトのy軸正方向を基準として、x軸周りの回転をPitch・z軸周りの回転をYawとするような球面状のリミットを、HeadからTailに向かう方向が基準となるよう最短経路で回転させた状態で定義します。 + +![球面リミットの図](./figures/spherical-limit.png) + +以下に、球面リミットで指定する2つの角度であるPitch・Yawの図を示します。 + +![球面リミットのPitch・Yawの図](./figures/spherical-limit-pitch-yaw.png) + +### Rotation + +各リミットは、 `rotation` プロパティを変更することでリミットの向きを変更できます。 +各リミットは、オブジェクトのy軸正方向を基準として、各リミットの形状をHeadからTailに向かう方向が基準となるよう最短経路で回転させた状態が初期回転となりますが、その状態のローカル座標系から `rotation` だけ回転させた状態が適用されます。 + +![回転順序を示した動画](./figures/rotation.gif) + +HeadからTailに向かう方向がちょうどy軸負方向の場合、最短経路の回転が一意に定まらないため、その場合はX軸周りに180度回転させた状態が初期回転となるよう実装しなければいけません (MUST) 。 + +> HeadからTailに向かう方向がちょうどy軸負方向もしくはそれに近い場合、実装間での結果が安定しない可能性があります。アーティストは、SpringBone JointにLimitを適用する場合、できるだけy軸負方向に近い方向を避けることを推奨します。 + +回転について、詳細な実装を[Appendix: Reference Implementations](#appendix-reference-implementations)に示します。 + +### Limit Application Order + +リミットによる角度制限は、以下のすべてのタイミングで適用することが推奨されます（SHOULD）。 + +- 慣性計算の直後 +- 各コライダーとの衝突が発生した場合、その直後 + +## glTF Schema Updates + +### Extending Springs + +リミットは、 `VRMC_springBone` で定義されたジョイントに `VRMC_springBone_limit` 拡張を追加することで記述されます。 + +```json +{ + "extensionsUsed": [ + "VRMC_springBone", + "VRMC_springBone_limit" + ], + "extensions": { + "VRMC_springBone": { + "specVersion": "1.0", + "springs": [ + { + "joints": [ + { + "node": 0, + "hitRadius": 0.25, + "stiffness": 1.0, + "dragForce": 0.4, + "extensions": { + "VRMC_springBone_limit": { + "specVersion": "1.0-draft", + "limit": { + "cone": { + "angle": 0.785398, + "rotation": [ 0.0, 0.0, 0.0, 1.0 ] + } + } + } + } + }, + // ... + ] + }, + // ... + ], + // ... + } + }, + // 通常のglTF 2.0の情報 + "nodes": [ + // ... + ] +} +``` + +### VRMC_springBone_limit + +本拡張のルートオブジェクトです。 + +{ + "$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" ] +} + + +#### Properties + +||型|説明|必須| +|:-|:-|:-|:-| +|`specVersion`|`string`|この拡張のバージョン|✅ Yes| +|`limit`|[Limit](#limit)|リミットの定義|✅ Yes| + +#### JSON Schema + +[VRMC_springBone_limit.schema.json](schema/VRMC_springBone_limit.schema.json) + +#### VRMC_springBone_limit.specVersion ✅ + +`VRMC_springBone_limit` 拡張のバージョンを示します。値は `"1.0-draft"` でなければなりません。 + +- 型: `string` +- 必須: Yes + +#### VRMC_springBone_limit.limit ✅ + +スプリングに適用するリミットを定義します。 + +- 型: [Limit](#limit) +- 必須: Yes + +### Limit + +スプリングに適用するリミットを定義します。 + +`cone` ・ `hinge` ・ `spherical` のうち、いずれか一つのみを含む必要があります。 + +#### Properties + +||型|説明|必須| +|:-|:-|:-|:-| +|`cone`|[ConeLimit](#conelimit)|コーンリミット|No| +|`hinge`|[HingeLimit](#hingelimit)|ヒンジリミット|No| +|`spherical`|[SphericalLimit](#sphericallimit)|球面リミット|No| + +#### JSON Schema + +[VRMC_springBone_limit.limit.schema.json](schema/VRMC_springBone_limit.limit.schema.json) + +#### Limit.cone + +コーンリミットを定義します。 + +- 型: [ConeLimit](#conelimit) +- 必須: No + +#### Limit.hinge + +ヒンジリミットを定義します。 + +- 型: [HingeLimit](#hingelimit) +- 必須: No + +#### Limit.spherical + +球面リミットを定義します。 + +- 型: [SphericalLimit](#sphericallimit) +- 必須: No + +### ConeLimit + +コーンリミットを定義します。 + +#### Properties + +||型|説明|必須| +|:-|:-|:-|:-| +|`angle`|`number`|コーンリミットの角度（弧度法）|✅ Yes| +|`rotation`|`number[4]`|コーンリミットの相対回転|No| + +#### JSON Schema + +[VRMC_springBone_limit.cone.schema.json](schema/VRMC_springBone_limit.cone.schema.json) + +#### ConeLimit.angle ✅ + +コーンリミットの角度を示します。角度は弧度法で表され、0以上でなければなりません。 +角度がπ以上に設定された場合、角度は実装によってπとして解釈されます。 +角度をπに設定したとき、コーンの形状は球と同等になります。 + +- 型: `number` +- 必須: Yes + +#### ConeLimit.rotation + +コーンリミットのデフォルトの向きからの相対回転を示します。 +回転はクォータニオン（x, y, z, w）で表され、wがスカラー成分です。 + +- 型: `number[4]` +- 必須: No +- デフォルト: `[ 0.0, 0.0, 0.0, 1.0 ]` + +### HingeLimit + +ヒンジリミットを定義します。 + +#### Properties + +||型|説明|必須| +|:-|:-|:-|:-| +|`angle`|`number`|ヒンジリミットの角度（弧度法）|✅ Yes| +|`rotation`|`number[4]`|ヒンジリミットの相対回転|No| + +#### JSON Schema + +[VRMC_springBone_limit.hinge.schema.json](schema/VRMC_springBone_limit.hinge.schema.json) + +#### HingeLimit.angle ✅ + +ヒンジリミットの角度を示します。角度は弧度法で表され、0以上でなければなりません。 +角度がπ以上に設定された場合、角度は実装によってπとして解釈されます。 +角度をπに設定したとき、ヒンジの形状は円盤と同等になります。 + +- 型: `number` +- 必須: Yes + +#### HingeLimit.rotation + +ヒンジリミットのデフォルトの向きからの相対回転を示します。 +回転はクォータニオン（x, y, z, w）で表され、wがスカラー成分です。 + +- 型: `number[4]` +- 必須: No +- デフォルト: `[ 0.0, 0.0, 0.0, 1.0 ]` + +### SphericalLimit + +球面リミットを定義します。 + +#### Properties + +||型|説明|必須| +|:-|:-|:-|:-| +|`pitch`|`number`|球面リミットのPitch（弧度法）|✅ Yes| +|`yaw`|`number`|球面リミットのYaw（弧度法）|✅ Yes| +|`rotation`|`number[4]`|球面リミットの相対回転|No| + +#### JSON Schema + +[VRMC_springBone_limit.spherical.schema.json](schema/VRMC_springBone_limit.spherical.schema.json) + +#### SphericalLimit.pitch ✅ + +球面リミットのPitch角度を示します。角度は弧度法で表され、0以上でなければなりません。 +角度がπ以上に設定された場合、角度は実装によってπとして解釈されます。 + +- 型: `number` +- 必須: Yes + +#### SphericalLimit.yaw ✅ + +球面リミットのYaw角度を示します。角度は弧度法で表され、0以上でなければなりません。 +角度がπ/2以上に設定された場合、角度は実装によってπ/2として解釈されます。 + +- 型: `number` +- 必須: Yes + +#### SphericalLimit.rotation + +球面リミットのデフォルトの向きからの相対回転を示します。 +回転はクォータニオン（x, y, z, w）で表され、wがスカラー成分です。 + +- 型: `number[4]` +- 必須: No +- デフォルト: `[ 0.0, 0.0, 0.0, 1.0 ]` + +## Appendix: Reference Implementations + +> *このセクションはNon-normativeです。* + +以下に、本拡張で定義する各リミットの参考実装を示します。 +`VRMC_springBone` 仕様内のリファレンス実装もあわせて参照してください。 + +### Overview + +[Limit Application Order](#limit-application-order) でも示した通り、リミットによる角度制限は、以下のすべてのタイミングで適用することが推奨されます。 + +- 慣性計算の直後 +- 各コライダーとの衝突が発生した場合、その直後 + +これを踏まえて、リミットによる角度制限を適用すべき対象となる値は、SpringBoneの慣性計算およびコライダーとの衝突判定の過程で利用する、そのJointが対象とする子Nodeのワールド空間における位置 `nextTail` となります。 +慣性計算ならびに各コライダーとの衝突判定の直後に、 `nextTail` の方向を指定された角度範囲に収めるように制限を適用します。 +これは、 `nextTail` のJoint位置からの相対的な長さの制限を行うタイミングと同一です。 + +以下の参考実装内において登場する `tailDir` は、制限するjointのワールド空間における方向を正規化された三次元ベクトルで表したものです。 +`nextTail` を利用して、以下の擬似コードのように定義します。 + +```ts +var tailDir = (nextTail - joint.worldPosition).normalized; +``` + +### Rotation + +以下に、各リミットをHeadからTailに向かう方向ならびに `rotation` プロパティを利用して回転させる参考実装を擬似コードで示します。 +`boneAxis` は、計算するJointが対象とする子Nodeの、ローカル空間におけるレスト状態の伸びる方向を表します。 + +```ts +// Y+方向からjointのheadからtailに向かうベクトルへの最小回転 +let axisRotation; + +// headからtailに向かうベクトルとY+方向との内積 +let dot = boneAxis.y; + +if (dot + 1 < 1e-8) { + // headからtailに向かうベクトルがY-方向に近い場合、X軸周りに180度回転させた回転を設定する + axisRotation = Quaternion(1, 0, 0, 0); +} else { + // それ以外の場合、Y+方向からjointのheadからtailに向かうベクトルへの最小回転を設定する + // quaternion(cross(from, to); dot(from, to) + 1).normalized + axisRotation = Quaternion(boneAxis.z, 0, -boneAxis.x, dot + 1).normalized; +} + +// limitのローカル空間をワールド空間に写像する回転 +let rotation = joint.parent.worldRotation * joint.localSpaceInitialRotation * axisRotation * joint.limit.rotation; + +// tailの向きをlimitのローカル空間に写像する +tailDir = tailDir.applyQuaternion(rotation.inverse); + +// limitを適用する +joint.limit.apply(tailDir); + +// tailの向きをワールド空間に戻す +tailDir = tailDir.applyQuaternion(rotation); +``` + +### ConeLimit + +以下は、擬似コードによるコーンリミットの参考実装です。 + +```ts +// tailDirのy要素をlimitに設定されたangleの余弦と比較する +let cosAngle = cos(limit.angle); +if (tailDir.y < cosAngle) { + // x・z要素を、tailDirの正弦とlimitに設定されたangleの正弦の比を用いてスケールする + let ratio = sqrt((1.0 - cosAngle * cosAngle) / (1.0 - tailDir.y * tailDir.y)); + tailDir.x *= ratio; + tailDir.z *= ratio; + + // y要素を、limitに設定されたangleの余弦とする + tailDir.y = cosAngle; +} +``` + +### HingeLimit + +以下は、擬似コードによるヒンジリミットの参考実装です。 + +```ts +// x要素を0にし、正規化する +tailDir.x = 0.0; +tailDir = tailDir.normalized; + +// tailDirのy要素をlimitに設定されたangleの余弦と比較する +let cosAngle = cos(limit.angle); +if (tailDir.y < cosAngle) { + // z要素を、tailDirの正弦とlimitに設定されたangleの正弦の比を用いてスケールする + let ratio = sqrt((1.0 - cosAngle * cosAngle) / (1.0 - tailDir.y * tailDir.y)); + tailDir.z *= ratio; + + // y要素を、limitに設定されたangleの余弦とする + tailDir.y = cosAngle; +} +``` + +### SphericalLimit + +以下は、擬似コードによる球面リミットの参考実装です。 + +```ts +// tailDirのpitch・yawを計算する +var pitch = atan2(tailDir.z, tailDir.y); +var yaw = asin(tailDir.x); + +// pitch・yawをlimitに設定されたpitch・yawを用いて制限する +if (abs(pitch) > limit.pitch) { + isLimited = true; + pitch = limit.pitch * sign(pitch); +} + +// yawをlimitに設定されたyawを用いて制限する +if (abs(yaw) > limit.yaw) { + isLimited = true; + yaw = limit.yaw * sign(yaw); +} + +// tailDirをpitch・yawを用いて再計算する +tailDir = vec3( + sin(yaw), + cos(yaw) * cos(pitch), + cos(yaw) * sin(pitch) +); +``` diff --git a/specification/VRMC_springBone_limit-1.0/README.md b/specification/VRMC_springBone_limit-1.0/README.md new file mode 100644 index 0000000..70e1696 --- /dev/null +++ b/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) diff --git a/specification/VRMC_springBone_limit-1.0/figures/cone-limit.png b/specification/VRMC_springBone_limit-1.0/figures/cone-limit.png new file mode 100644 index 0000000..610b138 Binary files /dev/null and b/specification/VRMC_springBone_limit-1.0/figures/cone-limit.png differ diff --git a/specification/VRMC_springBone_limit-1.0/figures/hinge-limit.png b/specification/VRMC_springBone_limit-1.0/figures/hinge-limit.png new file mode 100644 index 0000000..210363a Binary files /dev/null and b/specification/VRMC_springBone_limit-1.0/figures/hinge-limit.png differ diff --git a/specification/VRMC_springBone_limit-1.0/figures/rotation.gif b/specification/VRMC_springBone_limit-1.0/figures/rotation.gif new file mode 100644 index 0000000..c5916ed Binary files /dev/null and b/specification/VRMC_springBone_limit-1.0/figures/rotation.gif differ diff --git a/specification/VRMC_springBone_limit-1.0/figures/spherical-limit-pitch-yaw.png b/specification/VRMC_springBone_limit-1.0/figures/spherical-limit-pitch-yaw.png new file mode 100644 index 0000000..e781f54 Binary files /dev/null and b/specification/VRMC_springBone_limit-1.0/figures/spherical-limit-pitch-yaw.png differ diff --git a/specification/VRMC_springBone_limit-1.0/figures/spherical-limit.png b/specification/VRMC_springBone_limit-1.0/figures/spherical-limit.png new file mode 100644 index 0000000..f5081da Binary files /dev/null and b/specification/VRMC_springBone_limit-1.0/figures/spherical-limit.png differ diff --git a/specification/VRMC_springBone_limit-1.0/schema/VRMC_springBone_limit.coneLimit.schema.json b/specification/VRMC_springBone_limit-1.0/schema/VRMC_springBone_limit.coneLimit.schema.json new file mode 100644 index 0000000..2be4ce7 --- /dev/null +++ b/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" ] +} diff --git a/specification/VRMC_springBone_limit-1.0/schema/VRMC_springBone_limit.hingeLimit.schema.json b/specification/VRMC_springBone_limit-1.0/schema/VRMC_springBone_limit.hingeLimit.schema.json new file mode 100644 index 0000000..5ec42aa --- /dev/null +++ b/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" ] +} diff --git a/specification/VRMC_springBone_limit-1.0/schema/VRMC_springBone_limit.limit.schema.json b/specification/VRMC_springBone_limit-1.0/schema/VRMC_springBone_limit.limit.schema.json new file mode 100644 index 0000000..edf6e92 --- /dev/null +++ b/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" ] } + ] +} diff --git a/specification/VRMC_springBone_limit-1.0/schema/VRMC_springBone_limit.schema.json b/specification/VRMC_springBone_limit-1.0/schema/VRMC_springBone_limit.schema.json new file mode 100644 index 0000000..9434ca4 --- /dev/null +++ b/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" ] +} diff --git a/specification/VRMC_springBone_limit-1.0/schema/VRMC_springBone_limit.sphericalLimit.schema.json b/specification/VRMC_springBone_limit-1.0/schema/VRMC_springBone_limit.sphericalLimit.schema.json new file mode 100644 index 0000000..7962639 --- /dev/null +++ b/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" ] +}