A camera tied to a given frame. More...

#include <frame_view_controller.h>

Inheritance diagram for rviz::FrameViewController:

Public Member Functions
	FrameViewController ()

void	handleMouseEvent (ViewportMouseEvent &event) override

void	lookAt (const Ogre::Vector3 &point) override
	This should be implemented in each subclass to aim the camera at the given point in space (relative to the fixed frame). More...

void	mimic (ViewController *source_view) override
	Configure the settings of this view controller to give, as much as possible, a similar view as that given by the source_view. More...

void	move (float x, float y, float z)

void	onInitialize () override
	Do subclass-specific initialization. Called by ViewController::initialize after context_ and camera_ are set. Default implementation does nothing. More...

void	reset () override

void	rotate (float yaw, float pitch, float roll)

	~FrameViewController () override=default

Public Member Functions inherited from rviz::FramePositionTrackingViewController
	FramePositionTrackingViewController ()

void	mimic (ViewController *source_view) override
	Configure the settings of this view controller to give, as much as possible, a similar view as that given by the source_view. More...

void	onActivate () override
	called by activate(). More...

void	onInitialize () override
	Do subclass-specific initialization. More...

void	update (float dt, float ros_dt) override
	Called at 30Hz by ViewManager::update() while this view is active. Override with code that needs to run repeatedly. More...

	~FramePositionTrackingViewController () override

Public Member Functions inherited from rviz::ViewController
void	activate ()
	Called by RenderPanel when this view controller is about to be used. More...

void	emitConfigChanged ()
	Subclasses should call this whenever a change is made which would change the results of toString(). More...

Ogre::Camera *	getCamera () const

virtual QString	getClassId () const
	Return the class identifier which was used to create this instance. This version just returns whatever was set with setClassId(). More...

virtual QCursor	getCursor ()

QVariant	getViewData (int column, int role) const override
	Overridden from Property to give a different background color and bold font if this view is active. More...

Qt::ItemFlags	getViewFlags (int column) const override
	Overridden from Property to make this draggable if it is not active. More...

virtual void	handleKeyEvent (QKeyEvent event, RenderPanel panel)
	Called by MoveTool and InteractionTool when keyboard events are passed to them. More...

void	initialize (DisplayContext *context)
	Do all setup that can't be done in the constructor. More...

bool	isActive () const

void	load (const Config &config) override
	Load the value of this property and/or its children from the given Config reference. More...

void	lookAt (float x, float y, float z)
	Convenience function which calls lookAt(Ogre::Vector3). More...

void	save (Config config) const override
	Write the value of this property and/or its children into the given Config reference. More...

virtual void	setClassId (const QString &class_id)
	Set the class identifier used to create this instance. Typically this will be set by the factory object which created it. More...

virtual void	transitionFrom (ViewController *previous_view)
	Called by ViewManager when this ViewController is being made current. More...

	ViewController ()

	~ViewController () override

Public Member Functions inherited from rviz::Property
virtual void	addChild (Property *child, int index=-1)
	Add a child property. More...

Property *	childAt (int index) const
	Return the child Property with the given index, or NULL if the index is out of bounds or if the child at that index is not a Property. More...

virtual Property *	childAtUnchecked (int index) const
	Return the child Property with the given index, without checking whether the index is within bounds. More...

virtual void	collapse ()
	Collapse (hide the children of) this Property. More...

bool	contains (Property *possible_child) const
	Return true if the list of children includes possible_child, false if not. More...

virtual QWidget *	createEditor (QWidget *parent, const QStyleOptionViewItem &option)
	Create an editor widget to edit the value of this property. More...

virtual void	expand ()
	Expand (show the children of) this Property. More...

virtual QString	getDescription () const
	Return the description. More...

virtual bool	getDisableChildren ()
	If true, the children of this property should set their ItemIsEnabled flag to false. More...

virtual bool	getHidden () const
	Return the hidden/shown state. True means hidden, false means visible. More...

virtual QIcon	getIcon () const

PropertyTreeModel *	getModel () const
	Return the model managing this Property and its childrent. More...

virtual QString	getName () const
	Return the name of this Property as a QString. More...

std::string	getNameStd () const
	Return the name of this Property as a std::string. More...

Property *	getParent () const
	Return the parent Property. More...

virtual bool	getReadOnly ()
	Return the read-only-ness of this property. More...

virtual QVariant	getValue () const
	Return the value of this Property as a QVariant. If the value has never been set, an invalid QVariant is returned. More...

void	hide ()
	Hide this Property in any PropertyTreeWidgets. More...

void	insertChildSorted (Property *child)
	Insert a child property, sorted by name. More...

bool	isAncestorOf (Property *possible_child) const
	Returns true if `this` is an ancestor of possible_child, meaning is the parent or parent of parent etc. More...

virtual void	moveChild (int from_index, int to_index)
	Move the child at from_index to to_index. More...

virtual int	numChildren () const
	Return the number of child objects (Property or otherwise). More...

virtual bool	paint (QPainter *painter, const QStyleOptionViewItem &option) const
	Hook to provide custom painting of the value data (right-hand column) in a subclass. More...

	Property (const QString &name=QString(), const QVariant default_value=QVariant(), const QString &description=QString(), Property parent=nullptr, const char changed_slot=nullptr, QObject *receiver=nullptr)
	Constructor. More...

virtual void	removeChildren (int start_index=0, int count=-1)
	Remove and delete some or all child Properties. Does not change the value of this Property. More...

int	rowNumberInParent () const
	Return the row number of this property within its parent, or -1 if it has no parent. More...

virtual void	setDescription (const QString &description)
	Set the description. More...

virtual void	setHidden (bool hidden)
	Hide or show this property in any PropertyTreeWidget viewing its parent. More...

virtual void	setIcon (const QIcon &icon)
	Set the icon to be displayed next to the property. More...

void	setModel (PropertyTreeModel *model)
	Set the model managing this Property and all its child properties, recursively. More...

virtual void	setName (const QString &name)
	Set the name. More...

void	setParent (Property *new_parent)
	Set parent property, without telling the parent. More...

virtual void	setReadOnly (bool read_only)
	Prevent or allow users to edit this property from a PropertyTreeWidget. More...

void	setShouldBeSaved (bool save)
	If save is true and getReadOnly() is false, shouldBeSaved will return true; otherwise false. Default is true. More...

virtual bool	setValue (const QVariant &new_value)
	Set the new value for this property. Returns true if the new value is different from the old value, false if same. More...

bool	shouldBeSaved () const
	Returns true if the property is not read-only AND has data worth saving. More...

void	show ()
	Show this Property in any PropertyTreeWidgets. More...

virtual Property *	subProp (const QString &sub_name)
	Return the first child Property with the given name, or the FailureProperty if no child has the name. More...

Property *	takeChild (Property *child)
	Remove a given child object and return a pointer to it. More...

virtual Property *	takeChildAt (int index)
	Take a child out of the child list, but don't destroy it. More...

	~Property () override
	Destructor. Removes this property from its parent's list of children. More...

Protected Slots
void	changedAxis ()

void	changedOrientation ()

void	changedPosition ()

Protected Slots inherited from rviz::FramePositionTrackingViewController
virtual void	updateTargetFrame ()
	Called when Target Frame property changes while view is active. Purpose is to change values in the view controller (like a position offset) such that the actual viewpoint does not change. Calls updateTargetSceneNode() and onTargetFrameChanged(). More...

Protected Member Functions
int	actualCameraAxisOption (double precision=0.001) const
	find enum ID from camera's current pose More...

Ogre::Quaternion	getOrientation (float yaw, float pitch, float roll)

void	onTargetFrameChanged (const Ogre::Vector3 &, const Ogre::Quaternion &) override
	Override to implement the change in properties which nullifies the change in target frame. More...

void	setAxisFromCamera ()
	set axis_property_ from camera More...

void	setPropertiesFromCamera ()
	set yaw, pitch, roll, position properties from camera More...

void	updateTargetSceneNode () override
	Update the position of the target_scene_node_ from the TF frame specified in the Target Frame property. More...

Protected Member Functions inherited from rviz::FramePositionTrackingViewController
bool	getNewTransform ()

Protected Member Functions inherited from rviz::ViewController
void	setCursor (CursorType cursor_type)

void	setCursor (QCursor cursor)

void	setStatus (const QString &message)

Protected Member Functions inherited from rviz::Property
void	loadValue (const Config &config)
	Load the value of this property specifically, not including children. More...

Protected Attributes
EnumProperty *	axis_property_
	The axis that the camera aligns to. More...

BoolProperty *	locked_property_
	Lock camera, i.e. disable mouse interaction? More...

FloatProperty *	pitch_property_
	The camera's pitch (rotation around the y-axis), in radians. More...

VectorProperty *	position_property_
	The camera's position. More...

FloatProperty *	roll_property_
	The camera's roll (rotation around the x-axis), in radians. More...

FloatProperty *	yaw_property_
	The camera's yaw (rotation around the z-axis), in radians. More...

Protected Attributes inherited from rviz::FramePositionTrackingViewController
Ogre::Quaternion	reference_orientation_

Ogre::Vector3	reference_position_

TfFrameProperty *	target_frame_property_

Ogre::SceneNode *	target_scene_node_

Protected Attributes inherited from rviz::ViewController
Ogre::Camera *	camera_

DisplayContext *	context_

QCursor	cursor_

BoolProperty *	invert_z_

bool	is_active_

FloatProperty *	near_clip_property_

BoolProperty *	stereo_enable_

FloatProperty *	stereo_eye_separation_

BoolProperty *	stereo_eye_swap_

FloatProperty *	stereo_focal_distance_

Protected Attributes inherited from rviz::Property
bool	child_indexes_valid_
	True if row_number_within_parent_ of all children is valid, false if not. More...

QIcon	icon_

PropertyTreeModel *	model_
	Pointer to the PropertyTreeModel managing this property tree. More...

QVariant	value_
	This is the central property value. If you set it directly in a subclass, do so with care because many things depend on the aboutToChange() and changed() events emitted by setValue(). More...

Private Member Functions
void	rememberAxis (int current)

Private Attributes
int	previous_axis_

Additional Inherited Members
Signals inherited from rviz::ViewController
void	configChanged ()

Signals inherited from rviz::Property
void	aboutToChange ()
	Emitted by setValue() just before the value has changed. More...

void	changed ()
	Emitted by setValue() just after the value has changed. More...

void	childListChanged (Property *this_property)
	Emitted after insertions and deletions of child Properties. More...

Static Public Member Functions inherited from rviz::ViewController
static QString	formatClassId (const QString &class_id)

Protected Types inherited from rviz::ViewController
enum	CursorType { Default, Rotate2D, Rotate3D, MoveXY, MoveZ, Zoom, Crosshair }

Detailed Description

A camera tied to a given frame.

Definition at line 42 of file frame_view_controller.h.

Constructor & Destructor Documentation

◆ FrameViewController()

rviz::FrameViewController::FrameViewController ( )

Definition at line 58 of file frame_view_controller.cpp.

◆ ~FrameViewController()

rviz::FrameViewController::~FrameViewController ( )

overridedefault

Member Function Documentation

◆ actualCameraAxisOption()

int rviz::FrameViewController::actualCameraAxisOption ( double precision = 0.001 ) const

protected

find enum ID from camera's current pose

Definition at line 213 of file frame_view_controller.cpp.

◆ changedAxis

void rviz::FrameViewController::changedAxis ( )

protectedslot

Definition at line 285 of file frame_view_controller.cpp.

◆ changedOrientation

void rviz::FrameViewController::changedOrientation ( )

protectedslot

Definition at line 277 of file frame_view_controller.cpp.

◆ changedPosition

void rviz::FrameViewController::changedPosition ( )

protectedslot

Definition at line 246 of file frame_view_controller.cpp.

◆ getOrientation()

Ogre::Quaternion rviz::FrameViewController::getOrientation	(	float	yaw,
		float	pitch,
		float	roll
	)

protected

Definition at line 187 of file frame_view_controller.cpp.

◆ handleMouseEvent()

void rviz::FrameViewController::handleMouseEvent ( ViewportMouseEvent & event )

overridevirtual

Reimplemented from rviz::ViewController.

Definition at line 130 of file frame_view_controller.cpp.

◆ lookAt()

void rviz::FrameViewController::lookAt ( const Ogre::Vector3 & point )

overridevirtual

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.

Definition at line 124 of file frame_view_controller.cpp.

◆ mimic()

void rviz::FrameViewController::mimic ( ViewController * source_view )

overridevirtual

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().

This base class implementation does nothing.

Reimplemented from rviz::ViewController.

Definition at line 115 of file frame_view_controller.cpp.

◆ move()

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

Definition at line 240 of file frame_view_controller.cpp.

◆ onInitialize()

void rviz::FrameViewController::onInitialize ( )

overridevirtual

Do subclass-specific initialization. Called by ViewController::initialize after context_ and camera_ are set. Default implementation does nothing.

Reimplemented from rviz::ViewController.

Definition at line 93 of file frame_view_controller.cpp.

◆ onTargetFrameChanged()

void rviz::FrameViewController::onTargetFrameChanged	(	const Ogre::Vector3 &	,
		const Ogre::Quaternion &
	)

overrideprotectedvirtual

Override to implement the change in properties which nullifies the change in target frame.

See also: updateTargetFrame()

Reimplemented from rviz::FramePositionTrackingViewController.

Definition at line 297 of file frame_view_controller.cpp.

◆ rememberAxis()

void rviz::FrameViewController::rememberAxis ( int current )

inlineprivate

Definition at line 291 of file frame_view_controller.cpp.

◆ reset()

void rviz::FrameViewController::reset ( )

overridevirtual

Reset the view controller to some sane initial state, like looking at 0,0,0 from a few meters away.

Implements rviz::ViewController.

Definition at line 101 of file frame_view_controller.cpp.

◆ rotate()

void rviz::FrameViewController::rotate	(	float	yaw,
		float	pitch,
		float	roll
	)

Definition at line 269 of file frame_view_controller.cpp.

◆ setAxisFromCamera()

void rviz::FrameViewController::setAxisFromCamera ( )

protected

set axis_property_ from camera

Definition at line 229 of file frame_view_controller.cpp.

◆ setPropertiesFromCamera()

void rviz::FrameViewController::setPropertiesFromCamera ( )

protected

set yaw, pitch, roll, position properties from camera

Definition at line 196 of file frame_view_controller.cpp.

◆ updateTargetSceneNode()

void rviz::FrameViewController::updateTargetSceneNode ( )

overrideprotectedvirtual

Update the position of the target_scene_node_ from the TF frame specified in the Target Frame property.

global_status_->setStatus( StatusProperty::Error, "Target Frame", QString::fromStdString( error ));

Reimplemented from rviz::FramePositionTrackingViewController.

Definition at line 303 of file frame_view_controller.cpp.

Member Data Documentation

◆ axis_property_

EnumProperty* rviz::FrameViewController::axis_property_

protected

The axis that the camera aligns to.

Definition at line 72 of file frame_view_controller.h.

◆ locked_property_

BoolProperty* rviz::FrameViewController::locked_property_

protected

Lock camera, i.e. disable mouse interaction?

Definition at line 77 of file frame_view_controller.h.

◆ pitch_property_

FloatProperty* rviz::FrameViewController::pitch_property_

protected

The camera's pitch (rotation around the y-axis), in radians.

Definition at line 74 of file frame_view_controller.h.

◆ position_property_

VectorProperty* rviz::FrameViewController::position_property_

protected

The camera's position.

Definition at line 76 of file frame_view_controller.h.

◆ previous_axis_

int rviz::FrameViewController::previous_axis_

private

Definition at line 86 of file frame_view_controller.h.

◆ roll_property_

FloatProperty* rviz::FrameViewController::roll_property_

protected

The camera's roll (rotation around the x-axis), in radians.

Definition at line 75 of file frame_view_controller.h.

◆ yaw_property_

FloatProperty* rviz::FrameViewController::yaw_property_

protected

The camera's yaw (rotation around the z-axis), in radians.

Definition at line 73 of file frame_view_controller.h.

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

Public Member Functions

Protected Slots

Protected Member Functions

Protected Attributes

Private Member Functions

Private Attributes

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ FrameViewController()

◆ ~FrameViewController()

Member Function Documentation

◆ actualCameraAxisOption()

◆ changedAxis

◆ changedOrientation

◆ changedPosition

◆ getOrientation()

◆ handleMouseEvent()

◆ lookAt()

◆ mimic()

◆ move()

◆ onInitialize()

◆ onTargetFrameChanged()

◆ rememberAxis()

◆ reset()

◆ rotate()

◆ setAxisFromCamera()

◆ setPropertiesFromCamera()

◆ updateTargetSceneNode()

Member Data Documentation

◆ axis_property_

◆ locked_property_

◆ pitch_property_

◆ position_property_

◆ previous_axis_

◆ roll_property_

◆ yaw_property_