openglobus

Class: PlanetCamera

og/camera/PlanetCamera~PlanetCamera

Planet camera.

new PlanetCamera(planet, options)

og/camera/PlanetCamera.js, line 33
Name Type Description
planet RenderNode Planet render node.
options Object optional Planet camera options:
Name Type Default Description
name Object optional Camera name.
viewAngle number 37 optional Camera angle of view. Default is 35.0
near number optional Camera near plane distance. Default is 1.0
far number optional Camera far plane distance. Deafult is og.math.MAX
minAltitude number optional Minimal altitude for the camera. Deafult is 1
maxAltitude number optional Maximal altitude for the camera. Deafult is 20000000
eye Vec3 optional Camera eye position. Default (0,0,0)
look Vec3 optional Camera look position. Default (0,0,0)
up Vec3 optional Camera eye position. Default (0,1,0)

Extends

Members

protected_aspectNumber

Aspect ratio.

protected_bVec3

Camera forward vector.

protected_insideSegmentquadTree.Node

Quad node that camera flies over.

protected_insideSegmentPositionLonLat

Coordinates that depends on what segment class we are fling over. It can be WGS84 or Mercator coordinates. Gets in og.quadTree.Node

protected_lonLatLonLat

Current geographical degree position.

protected_lonLatMercLonLat

Current geographical mercator position.

protected_normalMatrixMat3

Camera normal matrix.

protected_rVec3

Camera right vector.

protected_terrainAltitudenumber

Current altitude.

protected_terrainPointVec3

Cartesian coordinates on the terrain.

protected_uVec3

Camera up vector.

protected_viewAngleNumber

Camera view angle in degrees

protected_viewMatrixMat4

Camera view matrix.

eventsEvents

Camera events handler

eyeVec3

Camera position.

eyeHighVec3

Camera RTE high position

eyeLowVec3

Camera RTE low position

maxAltitudenumber

Maximal alltitude that camera can reach over the globe.

minAltitudenumber

Minimal alltitude that camera can reach over the terrain.

planetPlanet

Assigned camera's planet.

rendererRenderer

Assigned renderer

Methods

inherited _init(renderer, options)

og/camera/Camera.js, line 208
Camera initialization.
Name Type Description
renderer Renderer OpenGlobus renderer object.
options Object optional Camera options:
Name Type Description
viewAngle number optional Camera angle of view. Default is 30.0
near number optional Camera near plane distance. Default is 1.0
far number optional Camera far plane distance. Deafult is og.math.MAX
eye Vec3 optional Camera eye position. Default (0,0,0)
look Vec3 optional Camera look position. Default (0,0,0)
up Vec3 optional Camera eye position. Default (0,1,0)

inherited _setProj(angle, aspect)

og/camera/Camera.js, line 317
Sets up camera projection
Name Type Description
angle nnumber Camera's view angle
aspect number Screen aspect ration

checkFly()

og/camera/PlanetCamera.js, line 581
Prepare camera to the frame. Used in render node frame function.

flyCartesian(cartesian, look, up, ampl, completeCallback, startCallback, frameCallback)

og/camera/PlanetCamera.js, line 366
Flies to the cartesian coordinates.
Name Type Default Description
cartesian Vec3 Finish cartesian coordinates.
look Vec3 optional Camera LOOK in the end of flying. Default - (0,0,0)
up Vec3 optional Camera UP vector in the end of flying. Default - (0,1,0)
ampl Number 1.0 optional Altitude amplitude factor.
completeCallback cameraCallback optional Callback that calls after flying when flying is finished.
startCallback cameraCallback optional Callback that calls befor the flying begins.
frameCallback optional

flyExtent(extent, up, ampl, completeCallback, startCallback, frameCallback)

og/camera/PlanetCamera.js, line 301
Flies to the current extent.
Name Type Description
extent Extent Current extent.
up Vec3 optional Camera UP in the end of flying. Default - (0,1,0)
ampl Number optional Altitude amplitude factor.
completeCallback cameraCallback optional Callback that calls after flying when flying is finished.
startCallback cameraCallback optional Callback that calls befor the flying begins.
frameCallback optional

flyLonLat(lonlat, look, up, ampl, completeCallback, startCallback)

og/camera/PlanetCamera.js, line 461
Flies to the geo coordiantes.
Name Type Description
lonlat LonLat Finish coordinates.
look Vec3 optional Camera LOOK in the end of flying. Default - (0,0,0)
up Vec3 optional Camera UP vector in the end of flying. Default - (0,1,0)
ampl Number optional Altitude amplitude factor.
completeCallback cameraCallback optional Callback that calls after flying when flying is finished.
startCallback cameraCallback optional Callback that calls befor the flying begins.

getAltitude()

og/camera/PlanetCamera.js, line 171
Gets altitude over the terrain.

inherited getAspectRatio(){number}

og/camera/Camera.js, line 307
Returns aspect ratio
Returns:
Type Description
number - Aspect ratio

getExtentPosition(extent, height){Vec3}

og/camera/PlanetCamera.js, line 217
Gets position by viewable extent.
Name Type Description
extent Extent Viewable extent.
height Number Camera height
Returns:
Type Description
Vec3

getHeight(){number}

og/camera/PlanetCamera.js, line 206
Returns camera height.
Returns:
Type Description
number

inherited getInverseProjectionMatrix(){Mat4}

og/camera/Camera.js, line 621
Returns inverse projection matrix.
Returns:
Type Description
Mat4 - Inversed projection-view matrix.

inherited getInverseProjectionViewMatrix(){Mat4}

og/camera/Camera.js, line 612
Returns inverse projection and model matrix product.
Returns:
Type Description
Mat4 - Inversed projection-view matrix.

getLonLat(){LonLat}

og/camera/PlanetCamera.js, line 197
Returns camera geographical position.
Returns:
Type Description
LonLat

inherited getNormalMatrix(){Mat3}

og/camera/Camera.js, line 564
Returns normal matrix.
Returns:
Type Description
Mat3 - Normal matrix.

inherited getProjectionMatrix(){Mat4}

og/camera/Camera.js, line 594
Returns projection matrix.
Returns:
Type Description
Mat4 - Projection matrix.

inherited getProjectionViewMatrix(){Mat4}

og/camera/Camera.js, line 603
Returns projection and model matrix product.
Returns:
Type Description
Mat4 - Projection-view matrix.

inherited getViewAngle(){number}

og/camera/Camera.js, line 350
Gets camera view angle in degrees
Returns:
Type Description
number angle -

inherited getViewMatrix(){Mat4}

og/camera/Camera.js, line 573
Returns model matrix.
Returns:
Type Description
Mat4 - View matrix.

isFlying(){boolean}

og/camera/PlanetCamera.js, line 494
Returns camera is flying.
Returns:
Type Description
boolean

inherited look(look, up)

og/camera/Camera.js, line 384
Sets camera look point
Name Type Description
look Vec3 Look point
up Vec3 optional Camera up vector otherwise camera current up vector(this._u)

inherited pitch(angle)

og/camera/Camera.js, line 431
Pitch the camera to the angle in degrees
Name Type Description
angle number Delta pitch angle in degrees

inherited project(v){Vec2}

og/camera/Camera.js, line 495
Gets projected 3d point to the 2d screen coordiantes
Name Type Description
v Vec3 Cartesian 3d coordiantes
Returns:
Type Description
Vec2 - Screen point coordinates

inherited projectedSize(p, r){number}

og/camera/Camera.js, line 555
Gets 3d size factor. Uses in LOD distance calculation.
Name Type Description
p Vec3 Far point.
r Vec3 Far point.
Returns:
Type Description
number - Size factor.

inherited refresh()

og/camera/Camera.js, line 287
Refresh camera matrices

inherited roll(angle)

og/camera/Camera.js, line 410
Roll the camera to the angle in degrees
Name Type Description
angle number Delta roll angle in degrees

inherited rotateAround(angle, isArc, center, up)

og/camera/Camera.js, line 510
Rotates camera around center point
Name Type Description
angle number Rotation angle in radians
isArc boolean If true camera up vector gets from current up vector every frame, otherwise up is always input parameter.
center Vec3 Point that the camera rotates around
up Vecto3 optional Camera up vector

rotateDown(angle)

og/camera/PlanetCamera.js, line 535
Rotates around planet to the south pole.
Name Type Description
angle number Rotation angle.

inherited rotateHorizontal(angle, isArc, center, up)

og/camera/Camera.js, line 535
Rotates camera around center point by horizontal.
Name Type Description
angle number Rotation angle in radians.
isArc boolaen If true camera up vector gets from current up vector every frame, otherwise up is always input parameter.
center Vec3 Point that the camera rotates around.
up Vec3 optional Camera up vector.

rotateLeft(angle, spin)

og/camera/PlanetCamera.js, line 504
Rotates around planet to the left.
Name Type Description
angle number Rotation angle.
spin boolean optional If its true rotates around globe spin.

rotateRight(angle, spin)

og/camera/PlanetCamera.js, line 515
Rotates around planet to the right.
Name Type Description
angle number Rotation angle.
spin boolean optional If its true rotates around globe spin.

rotateUp(angle)

og/camera/PlanetCamera.js, line 525
Rotates around planet to the north pole.
Name Type Description
angle number Rotation angle.

inherited rotateVertical(angle, center)

og/camera/Camera.js, line 544
Rotates camera around center point by vecrtical.
Name Type Description
angle number Rotation angle in radians.
center Vec3 Point that the camera rotates around.

inherited set(eye, look, up){Camera}

og/camera/Camera.js, line 362
Sets camera to eye position
Name Type Description
eye Vec3 Camera position
look Vec3 Look point
up Vec3 Camera up vector
Returns:
Type Description
Camera - This camera

setAltitude(alt)

og/camera/PlanetCamera.js, line 158
Sets altitude over the terrain.
Name Type Description
alt number Altitude over the terrain.

inherited setAspectRatio(aspect)

og/camera/Camera.js, line 297
Sets aspect ratio
Name Type Description
aspect Number Camera aspect ratio

setLonLat(lonlat, lookLonLat, up)

og/camera/PlanetCamera.js, line 182
Places camera to view to the geographical point.
Name Type Description
lonlat LonLat New camera and camera view position.
lookLonLat LonLat optional Look up coordinates.
up Vec3 optional Camera UP vector. Default (0,1,0)

inherited setViewAngle(angle)

og/camera/Camera.js, line 340
Sets camera view angle in degrees
Name Type Description
angle number View angle

inherited slide(du, dv, dn)

og/camera/Camera.js, line 399
Slides camera to vector d - (du, dv, dn)
Name Type Description
du number delta X
dv number delta Y
dn number delta Z

stopFlying()

og/camera/PlanetCamera.js, line 477
Breaks the flight.

inherited unproject(x, y){Vec3}

og/camera/Camera.js, line 475
Returns normal vector direction to to the unprojected screen point from camera eye
Name Type Description
x number Scren X coordinate
y number Scren Y coordinate
Returns:
Type Description
Vec3 - Direction vector

abstractupdate()

og/camera/PlanetCamera.js, line 130
Updates camera view space.

viewExtent(extent)

og/camera/PlanetCamera.js, line 285
View current extent.
Name Type Description
extent Extent Current extent.

inherited yaw(angle)

og/camera/Camera.js, line 452
Yaw the camera to the angle in degrees
Name Type Description
angle number Delta yaw angle in degrees