vpAROgre Class Reference

#include <visp3/ar/vpAROgre.h>

Inheritance diagram for vpAROgre:

Public Member Functions
	vpAROgre (const vpCameraParameters &cam=vpCameraParameters(), unsigned int width=0, unsigned int height=0, const char *resourcePath=VISP_HAVE_OGRE_RESOURCES_PATH, const char *pluginsPath=VISP_HAVE_OGRE_PLUGINS_PATH)
virtual	~vpAROgre (void)
void	addResource (const std::string &resourceLocation)
void	addRotation (const std::string &sceneName, const vpRotationMatrix &wRo)
bool	continueRendering (void)
virtual bool	customframeStarted (const Ogre::FrameEvent &evt)
virtual bool	customframeEnded (const Ogre::FrameEvent &evt)
virtual void	display (const vpImage< unsigned char > &I, const vpHomogeneousMatrix &cMw)
virtual void	display (const vpImage< vpRGBa > &I, const vpHomogeneousMatrix &cMw)
Ogre::Camera *	getCamera ()
double	getFarClippingDistance () const
double	getNearClippingDistance () const
vpTranslationVector	getPosition (const std::string &sceneName) const
void	getRenderingOutput (vpImage< vpRGBa > &I, const vpHomogeneousMatrix &cMo)
Ogre::SceneManager *	getSceneManager ()
virtual void	init (vpImage< unsigned char > &I, bool bufferedKeys=false, bool hidden=false)
virtual void	init (vpImage< vpRGBa > &I, bool bufferedKeys=false, bool hidden=false)
bool	isWindowHidden ()
virtual bool	keyPressed (const OIS::KeyEvent &)
virtual bool	keyReleased (const OIS::KeyEvent &)
void	load (const std::string &entityName, const std::string &model)
bool	renderOneFrame (const vpImage< unsigned char > &I, const vpHomogeneousMatrix &cMw)
bool	renderOneFrame (const vpImage< vpRGBa > &I, const vpHomogeneousMatrix &cMw)
void	setCameraParameters (const vpCameraParameters &cameraP)
void	setFarClippingDistance (const double &dist)
void	setNearClippingDistance (const double &dist)
void	setPluginsPath (const char *pluginsPath)
void	setPosition (const std::string &sceneName, const vpTranslationVector &wTo)
void	setPosition (const std::string &sceneName, const vpHomogeneousMatrix &wMo)
void	setResourcePath (const char *resourcePath)
void	setRotation (const std::string &sceneName, const vpRotationMatrix &wRo)
void	setScale (const std::string &sceneName, float factorx, float factory, float factorz)
void	setShowConfigDialog (bool showConfigDialog)
void	setVisibility (const std::string &sceneName, bool isVisible)
void	setWindowName (const Ogre::String &n)
void	setWindowPosition (unsigned int win_x, unsigned int win_y)
virtual void	windowClosed (Ogre::RenderWindow *rw)

Protected Member Functions
virtual void	init (bool bufferedKeys=false, bool hidden=false)
virtual void	createCamera (void)
virtual void	createScene (void)
virtual void	closeOIS (void)
virtual bool	updateScene (const Ogre::FrameEvent &)
virtual bool	processInputEvent (const Ogre::FrameEvent &)
virtual bool	destroyScene (void)
virtual void	updateCameraParameters (const vpHomogeneousMatrix &cMo)
virtual void	updateCameraProjection (void)
virtual void	updateBackgroundTexture (const vpImage< unsigned char > &I)
virtual void	updateBackgroundTexture (const vpImage< vpRGBa > &I)

Protected Attributes
Ogre::String	name
Ogre::Root *	mRoot
Ogre::Camera *	mCamera
Ogre::SceneManager *	mSceneMgr
Ogre::RenderWindow *	mWindow
Ogre::String	mResourcePath
Ogre::String	mPluginsPath
OIS::InputManager *	mInputManager
OIS::Keyboard *	mKeyboard
bool	keepOn
vpImage< vpRGBa >	mImageRGBA
vpImage< unsigned char >	mImage
Ogre::HardwarePixelBufferSharedPtr	mPixelBuffer
Ogre::Rectangle2D *	mBackground
unsigned int	mBackgroundHeight
unsigned int	mBackgroundWidth
unsigned int	mWindowHeight
unsigned int	mWindowWidth
bool	windowHidden
double	mNearClipping
double	mFarClipping
vpCameraParameters	mcam
bool	mshowConfigDialog
std::list< std::string >	mOptionnalResourceLocation

Detailed Description

Implementation of an augmented reality viewer using Ogre3D 3rd party.

Thus to be enabled this class requires Ogre3D 3rd party installation. Installation instructions are provided here https://visp.inria.fr/3rd_ogre.

This class provides methods to show a 3D scene in a real world. To do that you will need to initialise it with the parameters of your camera, then each frame you will need to compute a pose for your camera and give it to the application. With that information and the image to be shown in background it will set up the 3D scene correspondingly.

Examples:

AROgre.cpp, AROgreBasic.cpp, HelloWorldOgre.cpp, HelloWorldOgreAdvanced.cpp, tutorial-ibvs-4pts-ogre-tracking.cpp, and tutorial-ibvs-4pts-ogre.cpp.

Definition at line 90 of file vpAROgre.h.

Constructor & Destructor Documentation

vpAROgre()

vpAROgre::vpAROgre	(	const vpCameraParameters &	cam = vpCameraParameters(),
		unsigned int	width = 0,
		unsigned int	height = 0,
		const char *	resourcePath = VISP_HAVE_OGRE_RESOURCES_PATH,
		const char *	pluginsPath = VISP_HAVE_OGRE_PLUGINS_PATH
	)

Constructor.

Parameters

cam	: Camera parameters.
width	: Width of the window.
height	: Height of the window.
resourcePath	: Path to the resources.cfg file telling Ogre where to look for resources.
pluginsPath	: Path to the plugins.cfg of plugins_d.cfg files telling Ogre where to look for renderer plugins.

Examples:

AROgre.cpp, and HelloWorldOgreAdvanced.cpp.

Definition at line 73 of file vpAROgre.cpp.

~vpAROgre()

vpAROgre::~vpAROgre ( void  )

virtual

Destructor.

Definition at line 459 of file vpAROgre.cpp.

References closeOIS(), customframeEnded(), customframeStarted(), destroyScene(), keepOn, mRoot, mWindow, processInputEvent(), updateScene(), and windowClosed().

Member Function Documentation

addResource()

void vpAROgre::addResource ( const std::string &  resourceLocation )

inline

Add optional resource location. Since a resource file cannot be always sufficient to manage multiple location media (depending on the computer and the executable path), this method may be used to add such paths.

Warning

To be effective, this method must be called before the init() one.

Parameters

resourceLocation

: The resource location (it may be a folder or a zip file).

Examples:

tutorial-ibvs-4pts-ogre-tracking.cpp.

Definition at line 126 of file vpAROgre.h.

addRotation()

void vpAROgre::addRotation	(	const std::string &	sceneName,
		const vpRotationMatrix &	wRo
	)

Add a rotation to a SceneNode.

Parameters

sceneName	: Name of the SceneNode to rotate.
wRo	: The rotation matrix representing the rotation to apply.

Definition at line 717 of file vpAROgre.cpp.

References mSceneMgr.

closeOIS()

void vpAROgre::closeOIS ( void  )

protectedvirtual

Close the OIS based input manager.

Warning

This method is only to call if OIS is installed and detected during ViSP configuration stage.

Definition at line 925 of file vpAROgre.cpp.

References mInputManager, and mKeyboard.

Referenced by windowClosed(), and ~vpAROgre().

continueRendering()

bool vpAROgre::continueRendering

(

void

)

Ask the program if we can continue to render.

Returns

True if nothing stopped the rendering loop.

Definition at line 652 of file vpAROgre.cpp.

References keepOn.

createCamera()

void vpAROgre::createCamera ( void  )

protectedvirtual

Create the Ogre camera.

Definition at line 775 of file vpAROgre.cpp.

References mBackground, mBackgroundHeight, mBackgroundWidth, mCamera, mPixelBuffer, mRoot, and mSceneMgr.

Referenced by init().

createScene()

virtual void vpAROgre::createScene ( void  )

inlineprotectedvirtual

Build the 3D scene Override this to show what you want

Examples:

AROgre.cpp, and HelloWorldOgreAdvanced.cpp.

Definition at line 299 of file vpAROgre.h.

Referenced by init().

customframeEnded()

bool vpAROgre::customframeEnded ( const Ogre::FrameEvent &  evt )

virtual

Function telling what to do after each frame.

Parameters

evt	: Frame event to process.

Returns

True if everything went well.

Examples:

AROgre.cpp, and HelloWorldOgreAdvanced.cpp.

Definition at line 565 of file vpAROgre.cpp.

Referenced by ~vpAROgre().

customframeStarted()

bool vpAROgre::customframeStarted ( const Ogre::FrameEvent &  evt )

virtual

Function telling what to do before each frame. This method is called before every frame rendered by Ogre.

Parameters

evt	: Frame event to process

Returns

True if everything went well

Definition at line 545 of file vpAROgre.cpp.

References mKeyboard, and mWindow.

Referenced by ~vpAROgre().

destroyScene()

virtual bool vpAROgre::destroyScene ( void  )

inlineprotectedvirtual

Clean up the 3D scene.

Returns

Always true.

Definition at line 322 of file vpAROgre.h.

Referenced by ~vpAROgre().

display() [1/2]

void vpAROgre::display ( const vpImage< unsigned char > &  I, const vpHomogeneousMatrix &  cMw  )

virtual

Display a frame.

Parameters

I	: Grey level image to show in background.
cMw	: Camera pose as an homogeneous matrix.

Examples:

AROgre.cpp, and tutorial-ibvs-4pts-ogre-tracking.cpp.

Definition at line 623 of file vpAROgre.cpp.

References keepOn, mWindow, and renderOneFrame().

Referenced by vpMbHiddenFaces< vpMbtPolygon >::displayOgre().

display() [2/2]

void vpAROgre::display ( const vpImage< vpRGBa > &  I, const vpHomogeneousMatrix &  cMw  )

virtual

Display a frame.

Parameters

I	: RGBa image to show in background.
cMw	: Camera pose as an homogeneous matrix.

Definition at line 638 of file vpAROgre.cpp.

References keepOn, mWindow, and renderOneFrame().

getCamera()

Ogre::Camera* vpAROgre::getCamera ( )

inline

Definition at line 143 of file vpAROgre.h.

Referenced by vpMbHiddenFaces< vpMbtPolygon >::isVisibleOgre().

getFarClippingDistance()

double vpAROgre::getFarClippingDistance ( ) const

inline

Get the far distance for clipping.

Returns

Far clipping value.

Definition at line 150 of file vpAROgre.h.

getNearClippingDistance()

double vpAROgre::getNearClippingDistance ( ) const

inline

Get the near distance for clipping.

Returns

Near clipping value.

Definition at line 157 of file vpAROgre.h.

getPosition()

vpTranslationVector vpAROgre::getPosition

(

const std::string &

sceneName

)

const

Get position of a SceneNode.

Parameters

sceneName

: Name of the SceneNode in the scene graph.

Returns

The position of the node.

Definition at line 689 of file vpAROgre.cpp.

References mSceneMgr.

getRenderingOutput()

void vpAROgre::getRenderingOutput	(	vpImage< vpRGBa > &	I,
		const vpHomogeneousMatrix &	cMo
	)

Get the result of the rendering loop.

Parameters

I	: The image on which to copy the result of the rendering loop.
cMo	: The desired camera pose.

Examples:

tutorial-ibvs-4pts-ogre-tracking.cpp.

Definition at line 1042 of file vpAROgre.cpp.

References vpImage< Type >::bitmap, vpImage< Type >::getHeight(), vpImage< Type >::getWidth(), mPixelBuffer, mWindow, vpImage< Type >::resize(), and updateCameraParameters().

getSceneManager()

Ogre::SceneManager* vpAROgre::getSceneManager ( )

inline

Examples:

tutorial-ibvs-4pts-ogre-tracking.cpp.

Definition at line 163 of file vpAROgre.h.

Referenced by vpMbHiddenFaces< vpMbtPolygon >::initOgre(), and vpMbHiddenFaces< vpMbtPolygon >::isVisibleOgre().

init() [1/3]

void vpAROgre::init ( vpImage< unsigned char > &  I, bool  bufferedKeys = false, bool  hidden = false  )

virtual

Initialisation of Ogre with a grey level background.

Load the plugins that are specified in the plugins.cfg or plugins_d.cfg files. These files are located in VISP_HAVE_OGRE_PLUGINS_PATH folder that is defined in vpConfig.h. Note that plugins.cfg file is always considered under Unix platforms. The file plugins_d.cfg is only considered under Windows when the build type is Debug.

Load also the resources that are defined in the resources.cfg file. This file is located in VISP_HAVE_OGRE_RESOURCES_PATH folder that is defined in vpConfig.h.

Create also the grey level background used to display the image.

Parameters

I	: Image that is displayed in the background.
bufferedKeys	: If true, use of buffered input for the keyboard (see Ogre documentation). Note that this parameter is only useful if OIS is used.
hidden	: If true, the created window will be hidden. Note that this functionnality requires Ogre3D 1.8.1 at least.

Exceptions

vpException::ioError

: If the required plugins.cfg / plugins_d.cfg or resources.cfg files are not accessible.

Examples:

AROgreBasic.cpp, HelloWorldOgre.cpp, and tutorial-ibvs-4pts-ogre-tracking.cpp.

Definition at line 115 of file vpAROgre.cpp.

References vpImage< Type >::getHeight(), vpImage< Type >::getWidth(), mBackgroundHeight, and mBackgroundWidth.

Referenced by init(), and vpMbHiddenFaces< vpMbtPolygon >::initOgre().

init() [2/3]

void vpAROgre::init ( vpImage< vpRGBa > &  I, bool  bufferedKeys = false, bool  hidden = false  )

virtual

Initialisation of Ogre with a color background.

Load the plugins that are specified in the plugins.cfg or plugins_d.cfg files. These files are located in VISP_HAVE_OGRE_PLUGINS_PATH folder that is defined in vpConfig.h. Note that plugins.cfg file is always considered under Unix platforms. The file plugins_d.cfg is only considered under Windows when the build type is Debug.

Load also the resources that are defined in the resources.cfg file. This file is located in VISP_HAVE_OGRE_RESOURCES_PATH folder that is defined in vpConfig.h.

Create also a color background used to display the image.

Parameters

I	: Image that is displayed in the background.
bufferedKeys	: If true, use of buffered input for the keyboard (see Ogre documentation). Note that this parameter is only useful if OIS is used.
hidden	: If true, the created window will be hidden. Note that this functionnality requires Ogre3D 1.8.1 at least.

Exceptions

vpException::ioError

: If the required plugins.cfg / plugins_d.cfg or resources.cfg files are not accessible.

Definition at line 165 of file vpAROgre.cpp.

References vpImage< Type >::getHeight(), vpImage< Type >::getWidth(), init(), mBackgroundHeight, and mBackgroundWidth.

init() [3/3]

void vpAROgre::init ( bool  bufferedKeys = false, bool  hidden = false  )

protectedvirtual

Initialisation of Ogre.

Load the plugins that are specified in the plugins.cfg or plugins_d.cfg files. These files are located in VISP_HAVE_OGRE_PLUGINS_PATH folder that is defined in vpConfig.h. Note that plugins.cfg file is always considered under Unix platforms. The file plugins_d.cfg is only considered under Windows when the build type is Debug.

Load also the resources that are defined in the resources.cfg file. This file is located in VISP_HAVE_OGRE_RESOURCES_PATH folder that is defined in vpConfig.h.

Parameters

bufferedKeys	: If true, use of buffered input for the keyboard (see Ogre documentation). Note that this parameter is only useful if OIS is used.
hidden	: If true, the created window will be hidden. Note that this functionnality requires Ogre3D 1.8.1 at least.

Exceptions

vpException::ioError

: If the required plugins.cfg / plugins_d.cfg or resources.cfg files are not accessible.

Definition at line 211 of file vpAROgre.cpp.

References vpIoTools::checkFilename(), createCamera(), createScene(), vpException::ioError, mBackgroundHeight, mBackgroundWidth, mCamera, mInputManager, mKeyboard, mOptionnalResourceLocation, mPluginsPath, mResourcePath, mRoot, mSceneMgr, mshowConfigDialog, mWindow, mWindowHeight, mWindowWidth, name, vpIoTools::splitChain(), updateCameraProjection(), and windowHidden.

isWindowHidden()

bool vpAROgre::isWindowHidden ( )

inline

Test if the window is hidden or not.

Warning

True if the window is hidden, false otherwise.

Definition at line 173 of file vpAROgre.h.

Referenced by vpMbHiddenFaces< vpMbtPolygon >::displayOgre().

keyPressed()

virtual bool vpAROgre::keyPressed ( const OIS::KeyEvent &  )

inlinevirtual

Default event handler

Definition at line 179 of file vpAROgre.h.

keyReleased()

virtual bool vpAROgre::keyReleased ( const OIS::KeyEvent &  )

inlinevirtual

Default event handler

Definition at line 183 of file vpAROgre.h.

load()

void vpAROgre::load	(	const std::string &	entityName,
		const std::string &	model
	)

Load a mesh in the 3D world.

Parameters

entityName	: Name of the Entity and SceneNode to create.
model	: 3D model to load.

Examples:

tutorial-ibvs-4pts-ogre-tracking.cpp.

Definition at line 664 of file vpAROgre.cpp.

References mSceneMgr.

processInputEvent()

virtual bool vpAROgre::processInputEvent ( const Ogre::FrameEvent &  )

inlineprotectedvirtual

Check for keyboard, mouse and joystick inputs.

Returns

Always true.

Examples:

AROgre.cpp.

Definition at line 315 of file vpAROgre.h.

Referenced by ~vpAROgre().

renderOneFrame() [1/2]

bool vpAROgre::renderOneFrame	(	const vpImage< unsigned char > &	I,
		const vpHomogeneousMatrix &	cMw
	)

Render one frame.

Parameters

I	: Grey level image to show in background.
cMw	: Camera pose as an homogeneous matrix.

Definition at line 589 of file vpAROgre.cpp.

References mRoot, updateBackgroundTexture(), and updateCameraParameters().

Referenced by vpMbHiddenFaces< vpMbtPolygon >::computeScanLineQuery(), and display().

renderOneFrame() [2/2]

bool vpAROgre::renderOneFrame	(	const vpImage< vpRGBa > &	I,
		const vpHomogeneousMatrix &	cMw
	)

Render one frame.

Parameters

I	: RGBa image to show in background.
cMw	: Camera pose as an homogeneous matrix.

Definition at line 606 of file vpAROgre.cpp.

References mRoot, updateBackgroundTexture(), and updateCameraParameters().

setCameraParameters()

void vpAROgre::setCameraParameters

(

const vpCameraParameters &

cameraP

)

Set the camera intrinsic parameters

Examples:

tutorial-ibvs-4pts-ogre-tracking.cpp.

Definition at line 657 of file vpAROgre.cpp.

References mcam.

Referenced by vpMbHiddenFaces< vpMbtPolygon >::initOgre().

setFarClippingDistance()

void vpAROgre::setFarClippingDistance ( const double &  dist )

inline

Set the far distance for clipping.

Parameters

dist	: Far clipping value.

Definition at line 199 of file vpAROgre.h.

Referenced by vpMbTracker::setFarClippingDistance().

setNearClippingDistance()

void vpAROgre::setNearClippingDistance ( const double &  dist )

inline

Set the near distance for clipping.

Parameters

dist	: Near clipping value.

Definition at line 210 of file vpAROgre.h.

Referenced by vpMbTracker::setNearClippingDistance().

setPluginsPath()

void vpAROgre::setPluginsPath ( const char *  pluginsPath )

inline

Set the plugins path used to locate the plugins.cfg file.

By default, this path is set to VISP_HAVE_OGRE_PLUGINS_PATH defined in vpConfig.h

Warning

To be effective, this method must be called before the init() one.

Parameters

pluginsPath

: The new plugins path (must not have a terminate /).

Definition at line 227 of file vpAROgre.h.

setPosition() [1/2]

void vpAROgre::setPosition	(	const std::string &	sceneName,
		const vpTranslationVector &	wTo
	)

Change position of a ScneneNode.

Parameters

sceneName	: Name of the SceneNode to move.
wTo	: New position of the node (translation between object frame and world frame).

Examples:

tutorial-ibvs-4pts-ogre-tracking.cpp.

Definition at line 677 of file vpAROgre.cpp.

References mSceneMgr.

Referenced by setPosition().

setPosition() [2/2]

void vpAROgre::setPosition	(	const std::string &	sceneName,
		const vpHomogeneousMatrix &	wMo
	)

Set the position and the orientation of a SceneNode.

Parameters

sceneName	: Name of the SceneNode to rotate.
wMo	: The homogeneous matrix representing the rotation and translation to apply.

Definition at line 735 of file vpAROgre.cpp.

References vpHomogeneousMatrix::extract(), setPosition(), and setRotation().

setResourcePath()

void vpAROgre::setResourcePath ( const char *  resourcePath )

inline

Set the resource path used to locate the resource.cfg file.

By default, this path is set to VISP_HAVE_OGRE_RESOURCES_PATH defined in vpConfig.h

Warning

To be effective, this method must be called before the init() one.

Parameters

resourcePath

: The new resource path (must not have a terminate /).

Definition at line 243 of file vpAROgre.h.

setRotation()

void vpAROgre::setRotation	(	const std::string &	sceneName,
		const vpRotationMatrix &	wRo
	)

Set the orientation of a SceneNode.

Parameters

sceneName	: Name of the SceneNode to rotate.
wRo	: The rotation matrix representing the rotation to apply.

Examples:

tutorial-ibvs-4pts-ogre-tracking.cpp.

Definition at line 700 of file vpAROgre.cpp.

References mSceneMgr.

Referenced by setPosition().

setScale()

void vpAROgre::setScale	(	const std::string &	sceneName,
		float	factorx,
		float	factory,
		float	factorz
	)

Scale a SceneNode.

Parameters

sceneName	: Name of the SceneNode.
factorx	: Scale factor along the x-axis.
factory	: Scale factor along the x-axis.
factorz	: Scale factor along the x-axis.

Examples:

tutorial-ibvs-4pts-ogre-tracking.cpp.

Definition at line 764 of file vpAROgre.cpp.

References mSceneMgr.

setShowConfigDialog()

void vpAROgre::setShowConfigDialog ( bool  showConfigDialog )

inline

Enable/Disable the appearance of the config dialog on startup.

Warning

To be effective, this method must be called before the init() one.

Parameters

showConfigDialog

: if true, shows the dialog window (used to set the display options)

Examples:

tutorial-ibvs-4pts-ogre-tracking.cpp, and tutorial-ibvs-4pts-ogre.cpp.

Definition at line 258 of file vpAROgre.h.

Referenced by vpMbHiddenFaces< vpMbtPolygon >::initOgre().

setVisibility()

void vpAROgre::setVisibility	(	const std::string &	sceneName,
		bool	isVisible
	)

Tell if a SceneNode is shown on the screen or not.

Parameters

sceneName	: Name of the SceneNode.
isVisible	: If true we show the node, if false we don't.

Definition at line 752 of file vpAROgre.cpp.

References mSceneMgr.

setWindowName()

void vpAROgre::setWindowName ( const Ogre::String &  n )

inline

Set the name of the window.

Warning

Has to be called before initialisation.

Parameters

n	: Name of the window.

Definition at line 269 of file vpAROgre.h.

Referenced by vpMbDepthDenseTracker::setOgreVisibilityTest(), vpMbDepthNormalTracker::setOgreVisibilityTest(), vpMbKltTracker::setOgreVisibilityTest(), vpMbEdgeTracker::setOgreVisibilityTest(), vpMbGenericTracker::track(), vpMbDepthDenseTracker::vpMbDepthDenseTracker(), vpMbDepthNormalTracker::vpMbDepthNormalTracker(), vpMbEdgeKltTracker::vpMbEdgeKltTracker(), vpMbEdgeTracker::vpMbEdgeTracker(), and vpMbKltTracker::vpMbKltTracker().

setWindowPosition()

void vpAROgre::setWindowPosition ( unsigned int  win_x, unsigned int  win_y  )

inline

Set the window position in the screen.

Exceptions

vpException::notInitialised

if the window has not been created (using the init() method).

Parameters

win_x	: x coordinate of the new top left corner of the window in the screen.
win_y	: y coordinate of the new top left corner of the window in the screen.

Definition at line 281 of file vpAROgre.h.

References vpException::notInitialized.

updateBackgroundTexture() [1/2]

void vpAROgre::updateBackgroundTexture ( const vpImage< unsigned char > &  I )

protectedvirtual

Update the texture we see in background with a grey level image.

Definition at line 965 of file vpAROgre.cpp.

References vpImage< Type >::bitmap, mBackgroundHeight, mBackgroundWidth, and mPixelBuffer.

Referenced by renderOneFrame().

updateBackgroundTexture() [2/2]

void vpAROgre::updateBackgroundTexture ( const vpImage< vpRGBa > &  I )

protectedvirtual

Update the texture we see in background with a RGBa image.

Definition at line 985 of file vpAROgre.cpp.

References vpImage< Type >::bitmap, mBackgroundHeight, mBackgroundWidth, and mPixelBuffer.

updateCameraParameters()

void vpAROgre::updateCameraParameters ( const vpHomogeneousMatrix &  cMw )

protectedvirtual

Update Camera parameters from a pose calculation.

Definition at line 1022 of file vpAROgre.cpp.

References mCamera.

Referenced by getRenderingOutput(), and renderOneFrame().

updateCameraProjection()

void vpAROgre::updateCameraProjection ( void  )

protectedvirtual

Update the projection parameters of the camera.

Definition at line 942 of file vpAROgre.cpp.

References vpCameraParameters::get_px(), vpCameraParameters::get_py(), vpCameraParameters::get_u0(), vpCameraParameters::get_v0(), mBackgroundHeight, mBackgroundWidth, mcam, mCamera, mFarClipping, and mNearClipping.

Referenced by init().

updateScene()

virtual bool vpAROgre::updateScene ( const Ogre::FrameEvent &  )

inlineprotectedvirtual

Update the 3D scene

Returns

Always true.

Definition at line 308 of file vpAROgre.h.

Referenced by ~vpAROgre().

windowClosed()

void vpAROgre::windowClosed ( Ogre::RenderWindow *  rw )

virtual

Unattach OIS (Object-oriented Input System library) before window shutdown (very important under Linux).

Warning

This method is only available if OIS is installed and detected during ViSP configuration stage.

Parameters

rw	: RenderWindow to close.

Definition at line 577 of file vpAROgre.cpp.

References closeOIS(), and mWindow.

Referenced by ~vpAROgre().

Member Data Documentation

keepOn

bool vpAROgre::keepOn

protected

Definition at line 371 of file vpAROgre.h.

Referenced by continueRendering(), display(), and ~vpAROgre().

mBackground

Ogre::Rectangle2D* vpAROgre::mBackground

protected

Pointer to the pixel buffer

Definition at line 376 of file vpAROgre.h.

Referenced by createCamera().

mBackgroundHeight

unsigned int vpAROgre::mBackgroundHeight

protected

Background image

Definition at line 377 of file vpAROgre.h.

Referenced by createCamera(), init(), updateBackgroundTexture(), and updateCameraProjection().

mBackgroundWidth

unsigned int vpAROgre::mBackgroundWidth

protected

Height of the acquired image

Definition at line 378 of file vpAROgre.h.

Referenced by createCamera(), init(), updateBackgroundTexture(), and updateCameraProjection().

mcam

vpCameraParameters vpAROgre::mcam

protected

Far Clipping Distance

Examples:

AROgre.cpp.

Definition at line 386 of file vpAROgre.h.

Referenced by setCameraParameters(), and updateCameraProjection().

mCamera

Ogre::Camera* vpAROgre::mCamera

protected

Application's root

Definition at line 358 of file vpAROgre.h.

Referenced by createCamera(), init(), updateCameraParameters(), and updateCameraProjection().

mFarClipping

double vpAROgre::mFarClipping

protected

Near Clipping Distance

Definition at line 385 of file vpAROgre.h.

Referenced by updateCameraProjection().

mImage

vpImage<unsigned char> vpAROgre::mImage

protected

vpImage to store grabbed image

Definition at line 374 of file vpAROgre.h.

mImageRGBA

vpImage<vpRGBa> vpAROgre::mImageRGBA

protected

Has the application received a signal to stop(false) or not (true)

Definition at line 373 of file vpAROgre.h.

mInputManager

OIS::InputManager* vpAROgre::mInputManager

protected

Path to plugins.cfg

Definition at line 366 of file vpAROgre.h.

Referenced by closeOIS(), and init().

mKeyboard

OIS::Keyboard* vpAROgre::mKeyboard

protected

Definition at line 367 of file vpAROgre.h.

Referenced by closeOIS(), customframeStarted(), and init().

mNearClipping

double vpAROgre::mNearClipping

protected

Is window hidden

Definition at line 384 of file vpAROgre.h.

Referenced by updateCameraProjection().

mOptionnalResourceLocation

std::list<std::string> vpAROgre::mOptionnalResourceLocation

protected

if true, shows the dialog window (used to set the display options)

Definition at line 391 of file vpAROgre.h.

Referenced by init().

mPixelBuffer

Ogre::HardwarePixelBufferSharedPtr vpAROgre::mPixelBuffer

protected

vpImage to store grabbed image

Definition at line 375 of file vpAROgre.h.

Referenced by createCamera(), getRenderingOutput(), and updateBackgroundTexture().

mPluginsPath

Ogre::String vpAROgre::mPluginsPath

protected

Path to resources.cfg

Definition at line 362 of file vpAROgre.h.

Referenced by init().

mResourcePath

Ogre::String vpAROgre::mResourcePath

protected

Display window

Definition at line 361 of file vpAROgre.h.

Referenced by init().

mRoot

Ogre::Root* vpAROgre::mRoot

protected

Name of th Window

Definition at line 357 of file vpAROgre.h.

Referenced by createCamera(), init(), renderOneFrame(), and ~vpAROgre().

mSceneMgr

Ogre::SceneManager* vpAROgre::mSceneMgr

protected

Camera

Definition at line 359 of file vpAROgre.h.

Referenced by addRotation(), createCamera(), getPosition(), init(), load(), setPosition(), setRotation(), setScale(), and setVisibility().

mshowConfigDialog

bool vpAROgre::mshowConfigDialog

protected

The intrinsic camera parameters

Definition at line 388 of file vpAROgre.h.

Referenced by init().

mWindow

Ogre::RenderWindow* vpAROgre::mWindow

protected

Scene manager

Definition at line 360 of file vpAROgre.h.

Referenced by customframeStarted(), display(), getRenderingOutput(), init(), windowClosed(), and ~vpAROgre().

mWindowHeight

unsigned int vpAROgre::mWindowHeight

protected

Width of the acquired image

Definition at line 379 of file vpAROgre.h.

Referenced by init().

mWindowWidth

unsigned int vpAROgre::mWindowWidth

protected

Height of the window

Definition at line 380 of file vpAROgre.h.

Referenced by init().

name

Ogre::String vpAROgre::name

protected

Definition at line 354 of file vpAROgre.h.

Referenced by init().

windowHidden

bool vpAROgre::windowHidden

protected

Width of the window

Definition at line 381 of file vpAROgre.h.

Referenced by init().