LuciadCPillar 2023.1.04
luciad::MapNavigator::PitchConstraintOptions Class Referencefinal

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

#include <luciad/maps/MapNavigator.h>

Public Member Functions

double getMaxPitch () const
 Returns the maximum for the pitch of the 3D camera. More...
 
double getMinPitch () const
 Returns the minimum for the pitch of the 3D camera. More...
 
void setMaxPitch (double maxPitch)
 Sets the maximum for the pitch of the 3D camera. More...
 
void setMinPitch (double minPitch)
 Sets the minimum for the pitch of the 3D camera. More...
 

Detailed Description

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.

Since
2021.1

Member Function Documentation

◆ getMaxPitch()

double luciad::MapNavigator::PitchConstraintOptions::getMaxPitch ( ) const

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

Returns
the maximum pitch value
See also
setMaxPitch

◆ getMinPitch()

double luciad::MapNavigator::PitchConstraintOptions::getMinPitch ( ) const

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

Returns
the minimum pitch value
See also
setMinPitch

◆ setMaxPitch()

void luciad::MapNavigator::PitchConstraintOptions::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
maxPitchthe 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.

◆ setMinPitch()

void luciad::MapNavigator::PitchConstraintOptions::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
minPitchthe 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.