An orbital camera, controlled by yaw, pitch, distance, and focal point. More...

#include <orbit_view_controller.h>

Inheritance diagram for rviz::OrbitViewController:

Public Member Functions
virtual void	handleMouseEvent (ViewportMouseEvent &evt)
virtual void	lookAt (const Ogre::Vector3 &point)
	This should be implemented in each subclass to aim the camera at the given point in space (relative to the fixed frame).
virtual void	mimic (ViewController *source_view)
	Configure the settings of this view controller to give, as much as possible, a similar view as that given by the source_view.
void	move (float x, float y, float z)
virtual void	onInitialize ()
	Do subclass-specific initialization. Called by ViewController::initialize after context_, target_scene_node_, and camera_ are set.
	OrbitViewController ()
void	pitch (float angle)
virtual void	reset ()
void	yaw (float angle)
void	zoom (float amount)
	Move in/out from the focal point, ie. adjust #distance_ by amount.
virtual	~OrbitViewController ()
Protected Member Functions
void	calculatePitchYawFromPosition (const Ogre::Vector3 &position)
	Calculates pitch and yaw values given a new position and the current focal point.
virtual void	onTargetFrameChanged (const Ogre::Vector3 &old_reference_position, const Ogre::Quaternion &old_reference_orientation)
	Override to implement the change in properties which nullifies the change in target frame.
virtual void	update (float dt, float ros_dt)
	Called at 30Hz by ViewManager::update() while this view is active. Override with code that needs to run repeatedly.
virtual void	updateCamera ()
Protected Attributes
FloatProperty *	distance_property_
	The camera's distance from the focal point.
bool	dragging_
VectorProperty *	focal_point_property_
	The point around which the camera "orbits".
Shape *	focal_shape_
FloatProperty *	pitch_property_
	The camera's pitch (rotation around the x-axis), in radians.
FloatProperty *	yaw_property_
	The camera's yaw (rotation around the y-axis), in radians.

Detailed Description

An orbital camera, controlled by yaw, pitch, distance, and focal point.

This camera is based on the equation of a sphere in spherical coordinates:

 x = d*cos(theta)sin(phi)
 y = d*cos(phi)
 z = d*sin(theta)sin(phi)

Where:
d = #distance_
theta = #yaw_
phi = #pitch_

Definition at line 60 of file orbit_view_controller.h.

Constructor & Destructor Documentation

rviz::OrbitViewController::OrbitViewController ( )

Definition at line 58 of file orbit_view_controller.cpp.

rviz::OrbitViewController::~OrbitViewController ( ) [virtual]

Definition at line 85 of file orbit_view_controller.cpp.

Member Function Documentation

void rviz::OrbitViewController::calculatePitchYawFromPosition ( const Ogre::Vector3 & position ) [protected]

Calculates pitch and yaw values given a new position and the current focal point.

Parameters:

position Position to calculate the pitch/yaw for

Definition at line 277 of file orbit_view_controller.cpp.

void rviz::OrbitViewController::handleMouseEvent ( ViewportMouseEvent & evt ) [virtual]

Reimplemented from rviz::ViewController.

Reimplemented in rviz::XYOrbitViewController.

Definition at line 99 of file orbit_view_controller.cpp.

void rviz::OrbitViewController::lookAt ( const Ogre::Vector3 & point ) [virtual]

This should be implemented in each subclass to aim the camera at the given point in space (relative to the fixed frame).

Reimplemented from rviz::ViewController.

Reimplemented in rviz::XYOrbitViewController.

Definition at line 232 of file orbit_view_controller.cpp.

void rviz::OrbitViewController::mimic ( ViewController * source_view ) [virtual]

Configure the settings of this view controller to give, as much as possible, a similar view as that given by the source_view.

source_view must return a valid Ogre::Camera* from getCamera().

Reimplemented from rviz::FramePositionTrackingViewController.

Reimplemented in rviz::XYOrbitViewController.

Definition at line 200 of file orbit_view_controller.cpp.

void rviz::OrbitViewController::move	(	float	x,
		float	y,
		float	z
	)

Definition at line 289 of file orbit_view_controller.cpp.

void rviz::OrbitViewController::onInitialize ( ) [virtual]

Do subclass-specific initialization. Called by ViewController::initialize after context_, target_scene_node_, and camera_ are set.

Reimplemented from rviz::FramePositionTrackingViewController.

Reimplemented in rviz::XYOrbitViewController.

Definition at line 73 of file orbit_view_controller.cpp.

void rviz::OrbitViewController::onTargetFrameChanged	(	const Ogre::Vector3 &	old_reference_position,
		const Ogre::Quaternion &	old_reference_orientation
	)		`[protected, virtual]`