仕様書

[20] Pointer Lock (2016-10-19 08:10:29 +09:00) <https://w3c.github.io/pointerlock/>

API

メソッドと属性

[30]

イベント

[22] pointerlockchange イベントは、 Pointer Lock の状態変更を通知するために使われます >>21。

[24] 利用者エージェントは、 Pointer Lock の開始時と終了時に、 pointerlockchange イベントを送信しなければなりません >>21。

[87] スクリプトは、 pointerlockchange イベントを受信したら、 pointerLockElement IDL属性を確認することで、要求した要素に関する固定状態への移行に成功したしたかを判断できます。

[23] pointerlockerror イベントは、 Pointer Lock の状態変更の誤りを通知するために使われます >>21。

[60] Document インターフェイスは、 onpointerlockchange, onpointerlockerror 両IDL属性を持ちます。それぞれ、 pointerlockchange, pointerlockerror 各イベントのイベントハンドラーIDL属性です。 >>59

処理

固定状態への移行

[32] requestPointerLock メソッドは、次のようにしなければなりません >>31。

[35]
- [36] 文脈オブジェクトの節点文書の活性砂箱化フラグ集合の sandboxed pointer lock browsing context flag が設定されている
- [37] 次の条件のいずれかを満たさない
- [43] 文脈オブジェクトの影を含む根のPointer Lock要求不能が真
- [48] 対象が null ではなく、文脈オブジェクトの影を含む根が対象の影を含む根と異なる
... のいずれかを満たす場合、
1. [42] pointerlockerror イベントを文脈オブジェクトについて通知 (>>25) します。
[33] それ以外の場合、
1. [49] 対象が null でないなら、
  1. [50] pointerlockchange イベントを対象について通知 (>>25) します。
2. [66] それ以外の場合、
  1. [67] 元のマウスカーソル位置を、現在のマウスカーソルの位置に設定します。
3. [34] 対象を、文脈オブジェクトに設定します。
4. [41] pointerlockchange イベントを文脈オブジェクトについて通知 (>>25) します。

[44] 文書は、Pointer Lock要求不能フラグを持ちます。初期値は偽です。

[46] engagement gesture が発火される際は、影を含む根のPointer Lock要求不能フラグを偽に設定しなければなりません >>31。

[47] Pointer Lock要求不能フラグにより、利用者が Pointer Lock 状態を解除した場合にスクリプトから再度 Pointer Lock を開始することは拒否されます。これによって、むやみやたらに Pointer Lock 状態に入らせようとするのを拒み、利用者に他の動作を行う機会を与えます。 (exitPointerLock により解除からの requestPointerLock は拒絶されないので、自動的に解除と再設定を繰り返す必要がある場合はこの制限にかかりません。) >>31

[51] 対象が他の要素に変わる場合、新旧両要素で pointerlockchange を発火しなければならないことになりますが、その順序は不明です。また新旧が同じ場合にどうするべきなのかも不明です。

[69] 利用者エージェントは、元のマウスカーソル位置を持ちます。固定状態が終了すると、開始前の位置で再度マウスカーソルが表示されるようになります >>62。座標の他、マルチディスプレイの場合はどの画面に表示されていたかも復元されることが当然に期待されるものと思われます。元のマウスカーソル位置は、他に固定状態下でのマウスイベントの座標値の決定にも使われます。