WebGL API
NovoRender.CameraController
Camera motion controller.
Remarks
A motion controller fascilitates navigating a camera in space from user input.
Hierarchy​
CameraController
Properties​
autoZoomToScene​
• Optional autoZoomToScene: boolean
Whether to automatically zoom to scene extents when new scene is selected. Default is true.
enabled​
• enabled: boolean
Whether controller is enabled. Default is true.
fingersMap​
• fingersMap: Object
Defines touch fingers actions.
Param
defines how many fingers will rotate, pan and orbit camera.
Remarks
Default value: { rotate: 1, pan: 3, orbit: 3, pivot: 3 } rotate, pan and orbit are movement while holding fingers pivot is setting of pivot point for orbit rotation You could disable some action by do not set it or set to 0, like { rotate: 1, pan: 2 } or { rotate: 1, pan: 2, orbit: 0}
Type declaration​
| Name | Type |
|---|---|
orbit | number |
pan | number |
pivot | number |
rotate | number |
mouseButtonsMap​
• mouseButtonsMap: Object
Defines mouse buttons actions.
Param
Bitmask definition what buttons will rotate, pan and orbit camera.
Remarks
Bit mask of buttons: 1 - left button. 2 - right button. 4 - middle button. Default value: { rotate: 1, pan: 4, orbit: 2, pivot: 2 } rotate, pan and orbit are movement while button hold pivot is setting of pivot point for orbit rotation on button down You could disable some action by do not set it or set to 0, like { rotate: 1, pan: 2 } or { rotate: 1, pan: 2, orbit: 0} Here could be combination of buttons, for example if you want use right button for rotation and left or middle button for panning and no orbit then value should be { rotate: 2, pan: 5 }
Type declaration​
| Name | Type |
|---|---|
orbit | number |
pan | number |
pivot | number |
rotate | number |
params​
• Readonly params: Required<CameraControllerParams>
Controller parameters
Methods​
moveTo​
â–¸ moveTo(position, rotation): void
Move camera to exact position and rotation.
Parameters​
| Name | Type |
|---|---|
position | vec3 |
rotation | quat |
Returns​
void
â–¸ moveTo(position, rotation): void
Move camera to exact position and rotation.
Parameters​
| Name | Type |
|---|---|
position | ReadonlyVec3 |
rotation | ReadonlyQuat |
Returns​
void
reset​
â–¸ reset(): void
Reset camera position and rotation to scene default.
Returns​
void
zoomTo​
â–¸ zoomTo(bounds): void
Zoom to area of interest.
Parameters​
| Name | Type | Description |
|---|---|---|
bounds | BoundingSphere | The bounding volume that should be brought into view. |
Returns​
void
Remarks
Bounding volumes can be gotten from the scene itself, or an selection of objects within the scene. A typical case is to update the 3D view to reflect some object selection. The controller will attempt to position the camera at a reasonable distance from the specified volume, using its center as the focal point. The controller will not attempt to avoid moving through walls etc.
â–¸ zoomTo(bounds): void
Zoom to area of interest.
Parameters​
| Name | Type | Description |
|---|---|---|
bounds | BoundingSphere | The bounding volume that should be brought into view. |
Returns​
void
Remarks
Bounding volumes can be gotten from the scene itself, or an selection of objects within the scene. A typical case is to update the 3D view to reflect some object selection. The controller will attempt to position the camera at a reasonable distance from the specified volume, using its center as the focal point. The controller will not attempt to avoid moving through walls etc.