Class: PlanetCamera

Constructor

new PlanetCamera(planet, optionsopt)

Parameters:

Name Type Attributes Description

planet

Planet

Planet render node.

options

IPlanetCameraParams

Planet camera options:

Properties

Name	Type	Attributes	Description
`name`	string	<optional>	Camera name.
`viewAngle`	number	<optional>	Camera angle of view.
`near`	number	<optional>	Camera near plane distance. Default is 1.0
`far`	number	<optional>	Camera far plane distance. Default is og.math.MAX
`minAltitude`	number	<optional>	Minimal altitude for the camera. Default is 5
`maxAltitude`	number	<optional>	Maximal altitude for the camera. Default 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)

Source: camera/PlanetCamera.ts, line 27

Extends

Camera

Methods

_init(optionsopt)

Camera initialization.

Parameters:

Name Type Attributes Description

options

Object

Camera options:

Properties

Name	Type	Attributes	Description
`viewAngle`	number	<optional>	Camera angle of view.
`near`	number	<optional>	Camera near plane distance. Default is 1.0
`far`	number	<optional>	Camera far plane distance. Default is 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)

Overrides: Camera#_init
Source: camera/Camera.ts, line 319

_setProj(angle, aspect)

Sets up camera projection

Parameters:

Name	Type	Description
`angle`	number	Camera view angle
`aspect`	number	Screen aspect ratio

Overrides: Camera#_setProj
Source: camera/Camera.ts, line 445

checkFly()

Prepare camera to the frame. Used in render node frame function.

Source: camera/PlanetCamera.ts, line 653

flyCartesian(cartesian, lookopt, upopt, amplopt, completeCallbackopt, startCallbackopt, frameCallbackopt)

Flies to the cartesian coordinates.

Parameters:

Name	Type	Attributes	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	<optional>	1.0	Altitude amplitude factor.
`completeCallback`	function	<optional>		Callback that calls after flying when flying is finished.
`startCallback`	function	<optional>		Callback that calls before the flying begins.
`frameCallback`	function	<optional>		Each frame callback

Source: camera/PlanetCamera.ts, line 405

flyExtent(extent, heightopt, upopt, amplopt, completeCallbackopt, startCallbackopt, frameCallbackopt)

Flies to the current extent.

Parameters:

Name	Type	Attributes	Description
`extent`	Extent		Current extent.
`height`	number	<optional>	Destination height.
`up`	Vec3	<optional>	Camera UP in the end of flying. Default - (0,1,0)
`ampl`	Number	<optional>	Altitude amplitude factor.
`completeCallback`	function	<optional>	Callback that calls after flying when flying is finished.
`startCallback`	function	<optional>	Callback that calls before the flying begins.
`frameCallback`	function	<optional>	Each frame callback

Source: camera/PlanetCamera.ts, line 333

flyLonLat(lonlat, lookopt, upopt, amplopt, completeCallbackopt, startCallbackopt, frameCallbackopt)

Flies to the geo coordinates.

Parameters:

Name	Type	Attributes	Description
`lonlat`	LonLat		Finish coordinates.
`look`	Vec3 \| LonLat	<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`	function	<optional>	Callback that calls after flying when flying is finished.
`startCallback`	function	<optional>	Callback that calls befor the flying begins.
`frameCallback`	function	<optional>	each frame callback

Source: camera/PlanetCamera.ts, line 513

getAltitude()

Gets altitude over the terrain.

Source: camera/PlanetCamera.ts, line 205

getAspectRatio() → {number}

Returns aspect ratio

Overrides: Camera#getAspectRatio
Source: camera/Camera.ts, line 436

Returns:

Aspect ratio

Type:: number

getExtentPosition(extent, height) → {Vec3}

Gets position by viewable extent.

Parameters:

Name	Type	Description
`extent`	Extent	Viewable extent.
`height`	Number	Camera height

Source: camera/PlanetCamera.ts, line 248

Returns:

Type:: Vec3

getHeading()

should be yje same as getYaw

Source: camera/PlanetCamera.ts, line 709

getHeight() → {number}

Returns camera height.

Source: camera/PlanetCamera.ts, line 239

Returns:

Type:: number

getInverseProjectionMatrix() → {Mat4}

Returns inverse projection matrix.

Overrides: Camera#getInverseProjectionMatrix
Source: camera/Camera.ts, line 846

Returns:

Inverse projection-view matrix.

Type:: Mat4

getInverseProjectionViewMatrix() → {Mat4}

Returns inverse projection and model matrix product.

Overrides: Camera#getInverseProjectionViewMatrix
Source: camera/Camera.ts, line 837

Returns:

Inverse projection-view matrix.

Type:: Mat4

getLonLat() → {LonLat}

Returns camera geographical position.

Source: camera/PlanetCamera.ts, line 230

Returns:

Type:: LonLat

getNormalMatrix() → {NumberArray9}

Returns normal matrix.

Overrides: Camera#getNormalMatrix
Source: camera/Camera.ts, line 778

Returns:

Normal matrix.

Type:: NumberArray9

getProjectionMatrix() → {Mat4}

Returns projection matrix.

Overrides: Camera#getProjectionMatrix
Source: camera/Camera.ts, line 810

Returns:

Projection matrix.

Type:: Mat4

getProjectionViewMatrix() → {Mat4}

Returns projection and model matrix product.

Overrides: Camera#getProjectionViewMatrix
Source: camera/Camera.ts, line 819

Returns:

Projection-view matrix.

Type:: Mat4

getProjectionViewRTEMatrix() → {Mat4}

Returns projection and model RTE matrix product.

Overrides: Camera#getProjectionViewRTEMatrix
Source: camera/Camera.ts, line 828

Returns:

Projection-view matrix.

Type:: Mat4

getRotation()

Returns camera quaternion

Overrides: Camera#getRotation
Source: camera/Camera.ts, line 638

getViewAngle() → {number}

Gets camera view angle in degrees

Overrides: Camera#getViewAngle
Source: camera/Camera.ts, line 483

Returns:

angle -

Type:: number

getViewMatrix() → {NumberArray16}

Returns model matrix.

Overrides: Camera#getViewMatrix
Source: camera/Camera.ts, line 769

Returns:

View matrix.

Type:: NumberArray16

getYaw()

should be the same as getHeading

Source: camera/PlanetCamera.ts, line 736

isFlying() → {boolean}

Returns camera is flying.

Source: camera/PlanetCamera.ts, line 563

Returns:

Type:: boolean

look(look, upopt)

Sets camera look point

Parameters:

Name	Type	Attributes	Description
`look`	Vec3		Look point
`up`	Vec3	<optional>	Camera up vector otherwise camera current up vector(this._u)

Overrides: Camera#look
Source: camera/Camera.ts, line 529

project(x, y, z) → {Vec2}

Gets projected 3d point to the 2d screen coordinates

Parameters:

Name	Type	Description
`x`	number	X coordinate
`y`	number	Y coordinate
`z`	number	Z coordinate

Overrides: Camera#project
Source: camera/Camera.ts, line 703

Returns:

Screen point coordinates

Type:: Vec2

project3v(v) → {Vec2}

Gets projected 3d point to the 2d screen coordinates

Parameters:

Name	Type	Description
`v`	Vec3	Cartesian 3d coordinates

Overrides: Camera#project3v
Source: camera/Camera.ts, line 693

Returns:

Screen point coordinates

Type:: Vec2

projectedSize(p, r) → {number}

Gets 3d size factor. Uses in LOD distance calculation.

Parameters:

Name	Type	Description
`p`	Vec3	Far point.
`r`	Vec3	Far point.

Overrides: Camera#projectedSize
Source: camera/Camera.ts, line 758

Returns:

Size factor.

Type:: number

refresh()

Refresh camera matrices

Overrides: Camera#refresh
Source: camera/Camera.ts, line 403

rotateAround(angle, isArcopt, centeropt, upopt)

Rotates camera around center point

Parameters:

Name	Type	Attributes	Default	Description
`angle`	number			Rotation angle in radians
`isArc`	boolean	<optional>	false	If true camera up vector gets from current up vector every frame, otherwise up is always input parameter.
`center`	Vec3	<optional>		Point that the camera rotates around
`up`	Vec3	<optional>		Camera up vector

Overrides: Camera#rotateAround
Source: camera/Camera.ts, line 716

rotateDown(angle)

Rotates around planet to the South Pole.

Parameters:

Name	Type	Description
`angle`	number	Rotation angle.

Source: camera/PlanetCamera.ts, line 604

rotateHorizontal(angle, isArcopt, centeropt, upopt)

Rotates camera around center point by horizontal.

Parameters:

Name	Type	Attributes	Description
`angle`	number		Rotation angle in radians.
`isArc`	boolean	<optional>	If true camera up vector gets from current up vector every frame, otherwise up is always input parameter.
`center`	Vec3	<optional>	Point that the camera rotates around.
`up`	Vec3	<optional>	Camera up vector.

Overrides: Camera#rotateHorizontal
Source: camera/Camera.ts, line 736

rotateLeft(angle, spinopt)

Rotates around planet to the left.

Parameters:

Name	Type	Attributes	Description
`angle`	number		Rotation angle.
`spin`	boolean	<optional>	If its true rotates around globe spin.

Source: camera/PlanetCamera.ts, line 572

rotateRight(angle, spinopt)

Rotates around planet to the right.

Parameters:

Name	Type	Attributes	Description
`angle`	number		Rotation angle.
`spin`	boolean	<optional>	If its true rotates around globe spin.

Source: camera/PlanetCamera.ts, line 583

rotateUp(angle)

Rotates around planet to the North Pole.

Parameters:

Name	Type	Description
`angle`	number	Rotation angle.

Source: camera/PlanetCamera.ts, line 594

rotateVertical(angle, centeropt)

Rotates camera around center point by vertical.

Parameters:

Name	Type	Attributes	Description
`angle`	number		Rotation angle in radians.
`center`	Vec3	<optional>	Point that the camera rotates around.

Overrides: Camera#rotateVertical
Source: camera/Camera.ts, line 749

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

Sets camera to eye position

Parameters:

Name	Type	Description
`eye`	Vec3	Camera position
`look`	Vec3	Look point
`up`	Vec3	Camera up vector

Overrides: Camera#set
Source: camera/Camera.ts, line 504

Returns:

This camera

Type:: Camera

setAltitude(alt)

Sets altitude over the terrain.

Parameters:

Name	Type	Description
`alt`	number	Altitude over the terrain.

Source: camera/PlanetCamera.ts, line 188

setLonLat(lonlat, lookLonLatopt, upopt)

Places camera to view to the geographical point.

Parameters:

Name	Type	Attributes	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)

Source: camera/PlanetCamera.ts, line 213

setPitch(angle)

Pitch the camera to the angle in radians

Parameters:

Name	Type	Description
`angle`	number	Delta pitch angle in radians

Overrides: Camera#setPitch
Source: camera/Camera.ts, line 578

setRoll(angle)

Roll the camera to the angle in radians

Parameters:

Name	Type	Description
`angle`	number	Delta roll angle in radians

Overrides: Camera#setRoll
Source: camera/Camera.ts, line 557

setViewAngle(angle)

Sets camera view angle in degrees

Parameters:

Name	Type	Description
`angle`	number	View angle

Overrides: Camera#setViewAngle
Source: camera/Camera.ts, line 473

setYaw(angle)

Yaw the camera to the angle in radians

Parameters:

Name	Type	Description
`angle`	number	Delta yaw angle in radians

Overrides: Camera#setYaw
Source: camera/Camera.ts, line 599

slide(du, dv, dn)

Slides camera to vector d - (du, dv, dn)

Parameters:

Name	Type	Description
`du`	number	delta X
`dv`	number	delta Y
`dn`	number	delta Z

Overrides: Camera#slide
Source: camera/Camera.ts, line 544

stopFlying()

Breaks the flight.

Source: camera/PlanetCamera.ts, line 545

unproject(x, y) → {Vec3}

Returns normal vector direction to the unprojected screen point from camera eye

Parameters:

Name	Type	Description
`x`	number	Screen X coordinate
`y`	number	Screen Y coordinate

Overrides: Camera#unproject
Source: camera/Camera.ts, line 669

Returns:

Direction vector

Type:: Vec3

unproject2v(pos) → {Vec3}

Returns normal vector direction to the unprojected screen point from camera eye

Parameters:

Name	Type	Description
`pos`	Vec2	Screen X coordinate

Overrides: Camera#unproject2v
Source: camera/Camera.ts, line 659

Returns:

Direction vector

Type:: Vec3

(abstract) update()

Updates camera view space.

Overrides: Camera#update
Source: camera/PlanetCamera.ts, line 157

viewExtent(extent, heightopt)

View current extent.

Parameters:

Name	Type	Attributes	Description
`extent`	Extent		Current extent.
`height`	number	<optional>

Source: camera/PlanetCamera.ts, line 321