gazebo::rendering::DepthCamera Class Reference

Depth camera used to render depth data into an image buffer. More...

#include <rendering/rendering.hh>

Inheritance diagram for gazebo::rendering::DepthCamera:

Public Member Functions
	DepthCamera (const std::string &_namePrefix, Scene *_scene, bool _autoRender=true)
	Constructor.
virtual	~DepthCamera ()
	Destructor.
template<typename T >
event::ConnectionPtr	ConnectNewDepthFrame (T _subscriber)
	Connect a to the new depth image signal.
template<typename T >
event::ConnectionPtr	ConnectNewRGBPointCloud (T subscriber)
	Connect a to the new rgb point cloud signal.
void	CreateDepthTexture (const std::string &_textureName)
	Create a texture which will hold the depth data.
void	DisconnectNewDepthFrame (event::ConnectionPtr &_c)
	Disconnect from an depth image singal.
void	DisconnectNewRGBPointCloud (event::ConnectionPtr &c)
	Disconnect from an rgb point cloud singal.
void	Fini ()
	Finalize the camera.
virtual const float *	GetDepthData ()
	All things needed to get back z buffer for depth data.
void	Init ()
	Initialize the camera.
void	Load (sdf::ElementPtr &_sdf)
	Load the camera with a set of parmeters.
void	Load ()
	Load the camera with default parmeters.
virtual void	PostRender ()
	Render the camera.
virtual void	SetDepthTarget (Ogre::RenderTarget *_target)
	Set the render target, which renders the depth data.
Public Member Functions inherited from gazebo::rendering::Camera
	Camera (const std::string &_namePrefix, Scene *_scene, bool _autoRender=true)
	Constructor.
virtual	~Camera ()
	Destructor.
void	AttachToVisual (const std::string &_visualName, bool _inheritOrientation, double _minDist=0.0, double _maxDist=0.0)
	Attach the camera to a scene node.
template<typename T >
event::ConnectionPtr	ConnectNewImageFrame (T _subscriber)
	Connect a to the new image signal.
void	CreateRenderTexture (const std::string &_textureName)
	Set the render target.
void	DisconnectNewImageFrame (event::ConnectionPtr &_c)
	Disconnect from an image frame.
void	EnableSaveFrame (bool _enable)
	Enable or disable saving.
void	Fini ()
	Finalize the camera.
float	GetAspectRatio () const
	Get the apect ratio.
virtual float	GetAvgFPS ()
	Get the average FPS.
void	GetCameraToViewportRay (int _screenx, int _screeny, math::Vector3 &_origin, math::Vector3 &_dir)
	Get a world space ray as cast from the camera through the viewport.
math::Vector3	GetDirection () const
	Get the camera's direction vector.
double	GetFarClip ()
	Get the far clip distance.
math::Angle	GetHFOV () const
	Get the camera FOV (horizontal)
size_t	GetImageByteSize () const
	Get the image size in bytes.
virtual const unsigned char *	GetImageData (unsigned int i=0)
	Get a pointer to the image data.
unsigned int	GetImageDepth () const
	Get the depth of the image.
std::string	GetImageFormat () const
	Get the height of the image.
unsigned int	GetImageHeight () const
	Get the height of the image.
unsigned int	GetImageWidth () const
	Get the width of the image.
bool	GetInitialized () const
	Returns true if initialized.
common::Time	GetLastRenderWallTime ()
	Get the last time the camera was rendered.
std::string	GetName () const
	Get the camera's name.
double	GetNearClip ()
	Get the near clip distance.
Ogre::Camera *	GetOgreCamera () const
	Get a pointer to the ogre camera.
Ogre::Texture *	GetRenderTexture () const
	Get the render texture.
math::Vector3	GetRight ()
	Get the viewport right vector.
Scene *	GetScene () const
	Get the scene this camera is in.
Ogre::SceneNode *	GetSceneNode () const
	Get the camera's scene node.
unsigned int	GetTextureHeight () const
	Get the height of the off-screen render texture.
unsigned int	GetTextureWidth () const
	Get the width of the off-screen render texture.
virtual unsigned int	GetTriangleCount ()
	Get the triangle count.
math::Vector3	GetUp ()
	Get the viewport up vector.
math::Angle	GetVFOV () const
	Get the camera FOV (vertical)
Ogre::Viewport *	GetViewport () const
	Get a pointer to the Ogre::Viewport.
unsigned int	GetViewportHeight () const
	Get the viewport height in pixels.
unsigned int	GetViewportWidth () const
	Get the viewport width in pixels.
unsigned int	GetWindowId () const
	Get the ID of the window this camera is rendering into.
bool	GetWorldPointOnPlane (int _x, int _y, const math::Plane &_plane, math::Vector3 &_result)
	Get point on a plane.
math::Pose	GetWorldPose ()
	Get the global pose of the camera.
math::Vector3	GetWorldPosition () const
	Get the camera position in the world.
math::Quaternion	GetWorldRotation () const
	Get the camera's orientation in the world.
double	GetZValue (int _x, int _y)
	Get the Z-buffer value at the given image coordinate.
void	Init ()
	Initialize the camera.
bool	IsInitialized () const
	Return true if the camera has been initialized.
bool	IsVisible (VisualPtr _visual)
	Return true if the visual is within the camera's view frustum.
bool	IsVisible (const std::string &_visualName)
	Return true if the visual is within the camera's view frustum.
void	Load (sdf::ElementPtr _sdf)
	Load the camera with a set of parmeters.
void	Load ()
	Load the camera with default parmeters.
virtual bool	MoveToPosition (const math::Pose &_pose, double _time)
	Move the camera to a position.
bool	MoveToPositions (const std::vector< math::Pose > &_pts, double _time, boost::function< void()> _onComplete=NULL)
	Move the camera to a series of positions.
void	Render ()
	Render the camera.
void	RotatePitch (math::Angle _angle)
	Rotate the camera around the pitch axis.
void	RotateYaw (math::Angle _angle)
	Rotate the camera around the yaw axis.
bool	SaveFrame (const std::string &_filename)
	Save the last frame to disk.
void	SetAspectRatio (float _ratio)
	Set the aspect ratio.
void	SetCaptureData (bool _value)
	Set whether to capture data.
void	SetClipDist (float _near, float _far)
	Set the clip distances.
void	SetHFOV (math::Angle _angle)
	Set the camera FOV (horizontal)
void	SetImageHeight (unsigned int _h)
	Set the image height.
void	SetImageSize (unsigned int _w, unsigned int _h)
	Set the image size.
void	SetImageWidth (unsigned int _w)
	Set the image height.
void	SetName (const std::string &_name)
	Set the camera's name.
void	SetRenderRate (double _hz)
	Set the render Hz rate.
virtual void	SetRenderTarget (Ogre::RenderTarget *_target)
	Set the camera's render target.
void	SetSaveFramePathname (const std::string &_pathname)
	Set the save frame pathname.
void	SetScene (Scene *_scene)
	Set the scene this camera is viewing.
void	SetSceneNode (Ogre::SceneNode *_node)
	Set the camera's scene node.
void	SetWindowId (unsigned int _windowId)
virtual void	SetWorldPose (const math::Pose &_pose)
	Set the global pose of the camera.
void	SetWorldPosition (const math::Vector3 &_pos)
	Set the world position.
void	SetWorldRotation (const math::Quaternion &_quat)
	Set the world orientation.
void	ShowWireframe (bool _s)
	Set whether to view the world in wireframe.
void	ToggleShowWireframe ()
	Toggle whether to view the world in wireframe.
void	TrackVisual (const std::string &_visualName)
	Set the camera to track a scene node.
void	Translate (const math::Vector3 &_direction)
	Translate the camera.
virtual void	Update ()

Protected Attributes
Ogre::RenderTarget *	depthTarget
	Pointer to the depth target.
Ogre::Texture *	depthTexture
	Pointer to the depth texture.
Ogre::Viewport *	depthViewport
	Pointer to the depth viewport.
Protected Attributes inherited from gazebo::rendering::Camera
Ogre::AnimationState *	animState
unsigned char *	bayerFrameBuffer
Ogre::Camera *	camera
bool	captureData
std::vector< event::ConnectionPtr >	connections
int	imageFormat
int	imageHeight
int	imageWidth
bool	initialized
common::Time	lastRenderWallTime
std::string	name
bool	newData
event::EventT< void(const unsigned char *, unsigned int, unsigned int, unsigned int, const std::string &)>	newImageFrame
boost::function< void()>	onAnimationComplete
Ogre::SceneNode *	pitchNode
common::Time	prevAnimTime
Ogre::RenderTarget *	renderTarget
Ogre::Texture *	renderTexture
std::list< msgs::Request >	requests
unsigned int	saveCount
unsigned char *	saveFrameBuffer
Scene *	scene
Ogre::SceneNode *	sceneNode
sdf::ElementPtr	sdf
unsigned int	textureHeight
unsigned int	textureWidth
Ogre::Viewport *	viewport
unsigned int	windowId

Additional Inherited Members
Static Public Member Functions inherited from gazebo::rendering::Camera
static size_t	GetImageByteSize (unsigned int _width, unsigned int _height, const std::string &_format)
	Calculate image byte size base on a few parameters.
static bool	SaveFrame (const unsigned char *_image, unsigned int _width, unsigned int _height, int _depth, const std::string &_format, const std::string &_filename)
	Save a frame using an image buffer.
Protected Member Functions inherited from gazebo::rendering::Camera
virtual bool	AttachToVisualImpl (const std::string &_name, bool _inheritOrientation, double _minDist=0, double _maxDist=0)
	Attach the camera to a scene node.
virtual bool	AttachToVisualImpl (VisualPtr _visual, bool _inheritOrientation, double _minDist=0, double _maxDist=0)
	Attach the camera to a visual.
std::string	GetFrameFilename ()
	Get the next frame filename based on SDF parameters.
bool	TrackVisualImpl (const std::string &_visualName)
	Implementation of the Camera::TrackVisual call.
virtual bool	TrackVisualImpl (VisualPtr _visual)
	Set the camera to track a scene node.

Detailed Description

Depth camera used to render depth data into an image buffer.

Constructor & Destructor Documentation

gazebo::rendering::DepthCamera::DepthCamera	(	const std::string &	_namePrefix,
		Scene *	_scene,
		bool	_autoRender = true
	)

Constructor.

Parameters

[in]	_namePrefix	Unique prefix name for the camera.
[in]	_scene	Scene that will contain the camera
[in]	_autoRender	Almost everyone should leave this as true.

virtual gazebo::rendering::DepthCamera::~DepthCamera ( )

virtual

Destructor.

Member Function Documentation

template<typename T >

event::ConnectionPtr gazebo::rendering::DepthCamera::ConnectNewDepthFrame ( T  _subscriber )

inline

Connect a to the new depth image signal.

Parameters

[in]

_subscriber

Subscriber callback function

Returns

Pointer to the new Connection. This must be kept in scope

References gazebo::event::EventT< T >::Connect().

template<typename T >

event::ConnectionPtr gazebo::rendering::DepthCamera::ConnectNewRGBPointCloud ( T  subscriber )

inline

Connect a to the new rgb point cloud signal.

Parameters

[in]

_subscriber

Subscriber callback function

Returns

Pointer to the new Connection. This must be kept in scope

References gazebo::event::EventT< T >::Connect().

void gazebo::rendering::DepthCamera::CreateDepthTexture

(

const std::string &

_textureName

)

Create a texture which will hold the depth data.

Parameters

[in]

_textureName

Name of the texture to create

void gazebo::rendering::DepthCamera::DisconnectNewDepthFrame ( event::ConnectionPtr &  _c )

inline

Disconnect from an depth image singal.

Parameters

[in]

_c

The connection to disconnect

References gazebo::event::EventT< T >::Disconnect().

void gazebo::rendering::DepthCamera::DisconnectNewRGBPointCloud ( event::ConnectionPtr &  c )

inline

Disconnect from an rgb point cloud singal.

Parameters

[in]

_c

The connection to disconnect

References gazebo::event::EventT< T >::Disconnect().

void gazebo::rendering::DepthCamera::Fini

(

)

Finalize the camera.

virtual const float* gazebo::rendering::DepthCamera::GetDepthData ( )

virtual

All things needed to get back z buffer for depth data.

Returns

The z-buffer as a float array

void gazebo::rendering::DepthCamera::Init

(

)

Initialize the camera.

void gazebo::rendering::DepthCamera::Load

(

sdf::ElementPtr &

_sdf

)

Load the camera with a set of parmeters.

Parameters

[in]

_sdf

The SDF camera info

void gazebo::rendering::DepthCamera::Load

(

)

Load the camera with default parmeters.

virtual void gazebo::rendering::DepthCamera::PostRender ( )

virtual

Render the camera.

Reimplemented from gazebo::rendering::Camera.

virtual void gazebo::rendering::DepthCamera::SetDepthTarget ( Ogre::RenderTarget *  _target )

virtual

Set the render target, which renders the depth data.

Parameters

[in]

_target

Pointer to the render target

Member Data Documentation

Ogre::RenderTarget* gazebo::rendering::DepthCamera::depthTarget

protected

Pointer to the depth target.

Ogre::Texture* gazebo::rendering::DepthCamera::depthTexture

protected

Pointer to the depth texture.

Ogre::Viewport* gazebo::rendering::DepthCamera::depthViewport

protected

Pointer to the depth viewport.

---

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

• DepthCamera.hh