com.luciad.maps

Class MapNavigator.PitchConstraintOptions

java.lang.Object

com.luciad.maps.MapNavigator.PitchConstraintOptions

All Implemented Interfaces:

AutoCloseable

Enclosing class:

MapNavigator

public static final class MapNavigator.PitchConstraintOptions
extends Object
implements AutoCloseable

Options to configure the constraint to restrict the pitch (tilt) of the camera.

This constraint only works in 3D.

See MapNavigator#getPitchConstraint for more information.

Method Summary

Modifier and Type	Method and Description
void	close()
protected void	finalize()
double	getMaxPitch() Returns the maximum for the pitch of the 3D camera.
double	getMinPitch() Returns the minimum for the pitch of the 3D camera.
void	setMaxPitch(double maxPitch) Sets the maximum for the pitch of the 3D camera.
void	setMinPitch(double minPitch) Sets the minimum for the pitch of the 3D camera.

Methods inherited from class java.lang.Object

clone, equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

finalize

protected void finalize()

Overrides:

finalize in class Object

close

public void close()

Specified by:

close in interface AutoCloseable

setMinPitch

public void setMinPitch(double minPitch)

Sets the minimum for the pitch of the 3D camera.

Pitch is defined as the camera's tilt angle. A value of 0 points the camera towards the horizon (i.e. horizontally); -90 points straight down towards the ground (similar to a 2D top-down view) and +90 points straight up.

In other words, this property controls how far the camera can look up.

This camera constraint is only applied on 3D maps.

The default is -89.9, i.e. looking almost straight down.

Parameters:

minPitch - the minimum for the pitch of the 3D camera. It is advised not to use a value of 90 or -90. This can lead to the gimbal lock problem, leading to unstable camera movement.

getMinPitch

public double getMinPitch()

Returns the minimum for the pitch of the 3D camera.

Returns:

the minimum pitch value

See Also:

setMinPitch

setMaxPitch

public void setMaxPitch(double maxPitch)

Sets the maximum for the pitch of the 3D camera.

Pitch is defined as the camera's tilt angle. A value of 0 points the camera towards the horizon (i.e. horizontally); -90 points straight down towards the ground and +90 points straight up.

In other words, this property controls how far the camera can look down.

This camera constraint is only applied on 3D maps.

The default is +89.9, i.e. looking almost straight up.

Parameters:

maxPitch - the maximum for the pitch of the 3D camera. It is advised not to use a value of 90 or -90. This can lead to the gimbal lock problem, leading to unstable camera movement.

getMaxPitch

public double getMaxPitch()

Returns the maximum for the pitch of the 3D camera.

Returns:

the maximum pitch value

See Also:

setMaxPitch