vtkGeoCamera Class Reference

#include <vtkGeoCamera.h>

Inheritance diagram for vtkGeoCamera:

[legend]

Collaboration diagram for vtkGeoCamera:

[legend]

List of all members.

---

Detailed Description

Geo interface to a camera.

I wanted to hide the normal vtkCamera API so I did not make this a subclass. The camera is a helper object. You can get a pointer to the camera, but it should be treated like a const.

View up of the camera is restricted so there is no roll relative to the earth. I am going to keep view up of the camera orthogonalized to avoid the singularity that exists when the camera is pointing straight down. In this case, view up is the same as heading.

The state of the view is specified by the vector: (Longitude,Latitude,Distance,Heading,Tilt). Longitude in degrees: (-180->180) Relative to absolute coordinates. Latitude in degrees: (-90->90) Relative to Longitude. Distance in Meters Relative to Longitude and Latitude. above sea level ???? should we make this from center of earth ???? ???? what about equatorial bulge ???? Heading in degrees: (-180->180) Relative to Logitude and Latitude. 0 is north. 90 is east. ???? what is the standard ???? 180 is south. -90 is west. Tilt in degrees: (0->90) Relative to Longitude, Latitude, Distance and Heading.

Transformation: Post concatenate. All rotations use right hand rule and are around (0,0,0) (earth center). (0,0,0,0,0) is this rectilinear point (0, EarthRadius, 0) pointing (0,0,1), view up (0,1,0).

Rotate Tilt around x axis, Rotate Heading around -y axis Center, Translate EarthRadius in y direction. Rotate Latitude around x axis by Latitude, Rotate Longitude around z axis (earth axis),

See also:

vtkGeoInteractorStyle vtkCamera

Definition at line 81 of file vtkGeoCamera.h.

Public Types
typedef vtkObject	Superclass
Public Member Functions
virtual const char *	GetClassName ()
virtual int	IsA (const char *type)
void	PrintSelf (ostream &os, vtkIndent indent)
vtkCamera *	GetVTKCamera ()
void	InitializeNodeAnalysis (int rendererSize[2])
double	GetNodeCoverage (vtkGeoTerrainNode *node)
virtual double *	GetPosition ()
virtual void	GetPosition (double &, double &, double &)
virtual void	GetPosition (double[3])
void	SetLongitude (double longitude)
virtual double	GetLongitude ()
void	SetLatitude (double latitude)
virtual double	GetLatitude ()
void	SetDistance (double Distance)
virtual double	GetDistance ()
void	SetHeading (double heading)
virtual double	GetHeading ()
void	SetTilt (double tilt)
virtual double	GetTilt ()
virtual bool	GetLockHeading ()
virtual void	SetLockHeading (bool)
virtual void	LockHeadingOn ()
virtual void	LockHeadingOff ()
void	SetOriginLatitude (double oLat)
virtual double	GetOriginLatitude ()
void	SetOriginLongitude (double oLat)
virtual double	GetOriginLongitude ()
virtual double *	GetOrigin ()
virtual void	GetOrigin (double &, double &, double &)
virtual void	GetOrigin (double[3])
void	SetOrigin (double ox, double oy, double oz)
Static Public Member Functions
static vtkGeoCamera *	New ()
static int	IsTypeOf (const char *type)
static vtkGeoCamera *	SafeDownCast (vtkObject *o)
Protected Member Functions
	vtkGeoCamera ()
	~vtkGeoCamera ()
void	UpdateVTKCamera ()
void	UpdateAngleRanges ()
void	ComputeRectilinearOrigin ()
Protected Attributes
vtkSmartPointer< vtkCamera >	VTKCamera
vtkSmartPointer< vtkTransform >	Transform
double	OriginLatitude
double	OriginLongitude
double	Origin [3]
double	Longitude
double	Latitude
double	Distance
double	Heading
double	Tilt
bool	LockHeading
double	ForwardNormal [3]
double	RightNormal [3]
double	UpNormal [3]
double	Aspect [2]
double	LeftPlaneNormal [3]
double	RightPlaneNormal [3]
double	DownPlaneNormal [3]
double	UpPlaneNormal [3]
double	Position [3]

---

Member Typedef Documentation

typedef vtkObject vtkGeoCamera::Superclass

Reimplemented from vtkObject.

Definition at line 85 of file vtkGeoCamera.h.

---

Constructor & Destructor Documentation

vtkGeoCamera::vtkGeoCamera

(

)

[protected]

vtkGeoCamera::~vtkGeoCamera

(

)

[protected]

---

Member Function Documentation

static vtkGeoCamera* vtkGeoCamera::New

(

)

[static]

Create an object with Debug turned off, modified time initialized to zero, and reference counting on.

Reimplemented from vtkObject.

virtual const char* vtkGeoCamera::GetClassName

(

)

[virtual]

Reimplemented from vtkObject.

static int vtkGeoCamera::IsTypeOf

(

const char *

name

)

[static]

Return 1 if this class type is the same type of (or a subclass of) the named class. Returns 0 otherwise. This method works in combination with vtkTypeRevisionMacro found in vtkSetGet.h.

Reimplemented from vtkObject.

virtual int vtkGeoCamera::IsA

(

const char *

name

)

[virtual]

Return 1 if this class is the same type of (or a subclass of) the named class. Returns 0 otherwise. This method works in combination with vtkTypeRevisionMacro found in vtkSetGet.h.

Reimplemented from vtkObject.

static vtkGeoCamera* vtkGeoCamera::SafeDownCast

(

vtkObject *

o

)

[static]

Reimplemented from vtkObject.

void vtkGeoCamera::PrintSelf	(	ostream &	os,
		vtkIndent	indent
	)			[virtual]

Methods invoked by print to print information about the object including superclasses. Typically not called by the user (use Print() instead) but used in the hierarchical print process to combine the output of several classes.

Reimplemented from vtkObject.

virtual double* vtkGeoCamera::GetPosition

(

)

[virtual]

Get the world position without the origin shift.

virtual void vtkGeoCamera::GetPosition	(	double &	,
		double &	,
		double &
	)			[virtual]

Get the world position without the origin shift.

virtual void vtkGeoCamera::GetPosition

(

double

[3]

)

[virtual]

Get the world position without the origin shift.

void vtkGeoCamera::SetLongitude

(

double

longitude

)

Longitude is in degrees: (-180->180) Relative to absolute coordinates. Rotate Longitude around z axis (earth axis),

virtual double vtkGeoCamera::GetLongitude

(

)

[virtual]

Longitude is in degrees: (-180->180) Relative to absolute coordinates. Rotate Longitude around z axis (earth axis),

void vtkGeoCamera::SetLatitude

(

double

latitude

)

Latitude is in degrees: (-90->90) Relative to Longitude. Rotate Latitude around x axis by Latitude,

virtual double vtkGeoCamera::GetLatitude

(

)

[virtual]

Latitude is in degrees: (-90->90) Relative to Longitude. Rotate Latitude around x axis by Latitude,

void vtkGeoCamera::SetDistance

(

double

Distance

)

Distance is in Meters Relative to Longitude and Latitude. above sea level ???? should we make this from center of earth ???? ???? what about equatorial bulge ????

virtual double vtkGeoCamera::GetDistance

(

)

[virtual]

Distance is in Meters Relative to Longitude and Latitude. above sea level ???? should we make this from center of earth ???? ???? what about equatorial bulge ????

void vtkGeoCamera::SetHeading

(

double

heading

)

Heading is in degrees: (-180->180) Relative to Logitude and Latitude. 0 is north. 90 is east. ???? what is the standard ???? 180 is south. -90 is west. Rotate Heading around -y axis Center,

virtual double vtkGeoCamera::GetHeading

(

)

[virtual]

Heading is in degrees: (-180->180) Relative to Logitude and Latitude. 0 is north. 90 is east. ???? what is the standard ???? 180 is south. -90 is west. Rotate Heading around -y axis Center,

void vtkGeoCamera::SetTilt

(

double

tilt

)

Tilt is also know as pitch. Tilt is in degrees: (0->90) Relative to Longitude, Latitude, and Heading. Rotate Tilt around x axis,

virtual double vtkGeoCamera::GetTilt

(

)

[virtual]

Tilt is also know as pitch. Tilt is in degrees: (0->90) Relative to Longitude, Latitude, and Heading. Rotate Tilt around x axis,

vtkCamera* vtkGeoCamera::GetVTKCamera

(

)

This vtk camera is updated to match this geo cameras state. It should be treated as a const and should not be modified.

void vtkGeoCamera::InitializeNodeAnalysis

(

int

rendererSize[2]

)

We precompute some values to speed up update of the terrain. Unfortunately, they have to be manually/explicitely updated when the camera or renderer size changes.

double vtkGeoCamera::GetNodeCoverage

(

vtkGeoTerrainNode *

node

)

This method estimates how much of the view is covered by the sphere. Returns a value from 0 to 1.

virtual bool vtkGeoCamera::GetLockHeading

(

)

[virtual]

Whether to lock the heading a particular value, or to let the heading "roam free" when performing latitude and longitude changes.

virtual void vtkGeoCamera::SetLockHeading

(

bool

)

[virtual]

Whether to lock the heading a particular value, or to let the heading "roam free" when performing latitude and longitude changes.

virtual void vtkGeoCamera::LockHeadingOn

(

)

[virtual]

Whether to lock the heading a particular value, or to let the heading "roam free" when performing latitude and longitude changes.

virtual void vtkGeoCamera::LockHeadingOff

(

)

[virtual]

Whether to lock the heading a particular value, or to let the heading "roam free" when performing latitude and longitude changes.

void vtkGeoCamera::SetOriginLatitude

(

double

oLat

)

This point is shifted to 0,0,0 to avoid openGL issues.

virtual double vtkGeoCamera::GetOriginLatitude

(

)

[virtual]

This point is shifted to 0,0,0 to avoid openGL issues.

void vtkGeoCamera::SetOriginLongitude

(

double

oLat

)

This point is shifted to 0,0,0 to avoid openGL issues.

virtual double vtkGeoCamera::GetOriginLongitude

(

)

[virtual]

This point is shifted to 0,0,0 to avoid openGL issues.

virtual double* vtkGeoCamera::GetOrigin

(

)

[virtual]

Get the rectilinear cooridinate location of the origin. This is used to shift the terrain points.

virtual void vtkGeoCamera::GetOrigin	(	double &	,
		double &	,
		double &
	)			[virtual]

Get the rectilinear cooridinate location of the origin. This is used to shift the terrain points.

virtual void vtkGeoCamera::GetOrigin

(

double

[3]

)

[virtual]

Get the rectilinear cooridinate location of the origin. This is used to shift the terrain points.

void vtkGeoCamera::SetOrigin	(	double	ox,
		double	oy,
		double	oz
	)			[inline]

Get the rectilinear cooridinate location of the origin. This is used to shift the terrain points.

Definition at line 164 of file vtkGeoCamera.h.

void vtkGeoCamera::UpdateVTKCamera

(

)

[protected]

void vtkGeoCamera::UpdateAngleRanges

(

)

[protected]

void vtkGeoCamera::ComputeRectilinearOrigin

(

)

[protected]

---

Member Data Documentation

vtkSmartPointer<vtkCamera> vtkGeoCamera::VTKCamera [protected]

Definition at line 178 of file vtkGeoCamera.h.

vtkSmartPointer<vtkTransform> vtkGeoCamera::Transform [protected]

Definition at line 179 of file vtkGeoCamera.h.

double vtkGeoCamera::OriginLatitude [protected]

Definition at line 183 of file vtkGeoCamera.h.

double vtkGeoCamera::OriginLongitude [protected]

Definition at line 184 of file vtkGeoCamera.h.

double vtkGeoCamera::Origin[3] [protected]

Definition at line 185 of file vtkGeoCamera.h.

double vtkGeoCamera::Longitude [protected]

Definition at line 188 of file vtkGeoCamera.h.

double vtkGeoCamera::Latitude [protected]

Definition at line 189 of file vtkGeoCamera.h.

double vtkGeoCamera::Distance [protected]

Definition at line 190 of file vtkGeoCamera.h.

double vtkGeoCamera::Heading [protected]

Definition at line 191 of file vtkGeoCamera.h.

double vtkGeoCamera::Tilt [protected]

Definition at line 192 of file vtkGeoCamera.h.

bool vtkGeoCamera::LockHeading [protected]

Definition at line 193 of file vtkGeoCamera.h.

double vtkGeoCamera::ForwardNormal[3] [protected]

Definition at line 197 of file vtkGeoCamera.h.

double vtkGeoCamera::RightNormal[3] [protected]

Definition at line 198 of file vtkGeoCamera.h.

double vtkGeoCamera::UpNormal[3] [protected]

Definition at line 199 of file vtkGeoCamera.h.

double vtkGeoCamera::Aspect[2] [protected]

Definition at line 200 of file vtkGeoCamera.h.

double vtkGeoCamera::LeftPlaneNormal[3] [protected]

Definition at line 203 of file vtkGeoCamera.h.

double vtkGeoCamera::RightPlaneNormal[3] [protected]

Definition at line 204 of file vtkGeoCamera.h.

double vtkGeoCamera::DownPlaneNormal[3] [protected]

Definition at line 205 of file vtkGeoCamera.h.

double vtkGeoCamera::UpPlaneNormal[3] [protected]

Definition at line 206 of file vtkGeoCamera.h.

double vtkGeoCamera::Position[3] [protected]

Definition at line 208 of file vtkGeoCamera.h.

---

The documentation for this class was generated from the following file:

• dox/Geovis/vtkGeoCamera.h