|
|
@@ -7,6 +7,7 @@
|
|
|
<link type="text/css" rel="stylesheet" href="page.css" />
|
|
|
</head>
|
|
|
<body>
|
|
|
+ [page:Controls] →
|
|
|
|
|
|
<h1>第一人称控制器([name])</h1>
|
|
|
|
|
|
@@ -37,7 +38,7 @@
|
|
|
[page:Camera object]: 被控制的摄像机。
|
|
|
</p>
|
|
|
<p>
|
|
|
- [page:HTMLDOMElement domElement]: 用于事件监听的HTML元素。
|
|
|
+ [page:HTMLDOMElement domElement]: 用于事件监听的HTML元素。(可选)
|
|
|
</p>
|
|
|
<p>
|
|
|
创建一个新的 [name] 实例。
|
|
|
@@ -46,60 +47,52 @@
|
|
|
|
|
|
<h2>属性</h2>
|
|
|
|
|
|
+ <p>共有属性请参见其基类[page:Controls]。</p>
|
|
|
+
|
|
|
<h3>[property:Boolean activeLook]</h3>
|
|
|
<p>
|
|
|
- 是否能够环视四周。默认为*true*。
|
|
|
+ 是否能够环视四周。默认为 *true*。
|
|
|
</p>
|
|
|
|
|
|
<h3>[property:Boolean autoForward]</h3>
|
|
|
<p>
|
|
|
- 摄像机是否自动向前移动。默认为*false*。
|
|
|
+ 摄像机是否自动向前移动。默认为 *false*。
|
|
|
</p>
|
|
|
|
|
|
<h3>[property:Boolean constrainVertical]</h3>
|
|
|
<p>
|
|
|
- 垂直环视是否约束在[[page:.verticalMin], [page:.verticalMax]]之间。默认值为*false*。
|
|
|
- </p>
|
|
|
-
|
|
|
- <h3>[property:HTMLDOMElement domElement]</h3>
|
|
|
- <p>
|
|
|
- 该 HTMLDOMElement 用于监听鼠标/触摸事件,该属性必须在构造函数中传入。在此处改变它将不会设置新的事件监听。
|
|
|
- </p>
|
|
|
-
|
|
|
- <h3>[property:Boolean enabled]</h3>
|
|
|
- <p>
|
|
|
- 是否启用控制器。默认为*true*。
|
|
|
+ 垂直环视是否约束在[[page:.verticalMin], [page:.verticalMax]]之间。默认值为 *false*。
|
|
|
</p>
|
|
|
|
|
|
<h3>[property:Number heightCoef]</h3>
|
|
|
<p>
|
|
|
- 当Y坐标接近[page:.heightMax]时摄像机的移动速度。默认值为*1*。
|
|
|
+ 当Y坐标接近[page:.heightMax]时摄像机的移动速度。默认值为 *1*。
|
|
|
</p>
|
|
|
|
|
|
<h3>[property:Number heightMax]</h3>
|
|
|
<p>
|
|
|
- 用于调节移动速度的摄像机最大高度限制。默认值为*1*。
|
|
|
+ 用于调节移动速度的摄像机最大高度限制。默认值为 *1*。
|
|
|
</p>
|
|
|
|
|
|
<h3>[property:Number heightMin]</h3>
|
|
|
<p>
|
|
|
- 用于调节移动速度的摄像机最低高度限制。默认值为*0*。
|
|
|
+ 用于调节移动速度的摄像机最低高度限制。默认值为 *0*。
|
|
|
</p>
|
|
|
|
|
|
<h3>[property:Boolean heightSpeed]</h3>
|
|
|
<p>
|
|
|
- 摄像机的高度是否影响向前移动的速度。默认值为*false*。
|
|
|
+ 摄像机的高度是否影响向前移动的速度。默认值为 *false*。
|
|
|
使用属性 [page:.heightCoef]、 [page:.heightMin] 和 [page:.heightMax] 来进行配置。
|
|
|
</p>
|
|
|
|
|
|
<h3>[property:Boolean lookVertical]</h3>
|
|
|
<p>
|
|
|
- 是否能够垂直环视。默认为*true*。
|
|
|
+ 是否能够垂直环视。默认为 *true*。
|
|
|
</p>
|
|
|
|
|
|
<h3>[property:Number lookSpeed]</h3>
|
|
|
<p>
|
|
|
- 环视速度。默认为*0.005*。
|
|
|
+ 环视速度。默认为 *0.005*。
|
|
|
</p>
|
|
|
|
|
|
<h3>[property:Boolean mouseDragOn]</h3>
|
|
|
@@ -109,30 +102,22 @@
|
|
|
|
|
|
<h3>[property:Number movementSpeed]</h3>
|
|
|
<p>
|
|
|
- 移动速度。默认为*1*。
|
|
|
- </p>
|
|
|
-
|
|
|
- <h3>[property:Camera object]</h3>
|
|
|
- <p>
|
|
|
- 被控制的摄像机。
|
|
|
+ 移动速度。默认为 *1*。
|
|
|
</p>
|
|
|
|
|
|
<h3>[property:Number verticalMax]</h3>
|
|
|
<p>
|
|
|
- 你能够垂直环视角度的上限。范围在 0 到 Math.PI 弧度之间。默认为*Math.PI*。
|
|
|
+ 你能够垂直环视角度的上限。范围在 0 到 Math.PI 弧度之间。默认为 *Math.PI*。
|
|
|
</p>
|
|
|
|
|
|
<h3>[property:Number verticalMin]</h3>
|
|
|
<p>
|
|
|
- 你能够垂直环视角度的下限。范围在 0 到 Math.PI 弧度之间。默认为*0*。
|
|
|
+ 你能够垂直环视角度的下限。范围在 0 到 Math.PI 弧度之间。默认为 *0*。
|
|
|
</p>
|
|
|
|
|
|
<h2>方法</h2>
|
|
|
-
|
|
|
- <h3>[method:undefined dispose] ()</h3>
|
|
|
- <p>
|
|
|
- 若不再需要该控制器,则应当调用此函数。
|
|
|
- </p>
|
|
|
+
|
|
|
+ <p>共有方法请参见其基类[page:EventDispatcher]。</p>
|
|
|
|
|
|
<h3>[method:undefined handleResize] ()</h3>
|
|
|
<p>
|
|
|
@@ -155,16 +140,6 @@
|
|
|
</p>
|
|
|
</p>
|
|
|
|
|
|
- <h3>[method:undefined update] ( [param:Number delta] )</h3>
|
|
|
- <p>
|
|
|
- <p>
|
|
|
- [page:Number delta]:时间增量值。
|
|
|
- </p>
|
|
|
- <p>
|
|
|
- 更新控制器,常被用在动画循环中。
|
|
|
- </p>
|
|
|
- </p>
|
|
|
-
|
|
|
<h2>源代码</h2>
|
|
|
|
|
|
<p>
|