VgApplication::VgIManipulatorManager Class Reference

The VgIManipulatorManager interface is used to choose the way the user will interact with the Open GL surface. More...

Public Member Functions
virtual	~VgIManipulatorManager ()
	Destructor. More...
virtual bool	selectManipulator (const std::string &pName)=0
	Selects the current manipulator. More...
virtual std::string	getCurrentManipulator () const =0
	Returns the current manipulator's name. More...
virtual VgApplication::VgManipulator *	editManipulatorObject (const std::string &pManipulatorName)=0
	Returns a VgApplication::VgManipulator instance given its name. More...

Protected Member Functions
	VgIManipulatorManager ()
	Constructor. More...

Detailed Description

The VgIManipulatorManager interface is used to choose the way the user will interact with the Open GL surface.

Supported Manipulators

Currently, there are two supported manipulators:

• 3D
• Animation

For example, the "3D" manipulator supports various user-interactions on a touch-screen :

• move forward/backward : drag vertically with only one finger on the screen
• look right/left : drag horizontally with only one finger on the screen
• zoom in/out : Move two fingers in the opposite direction. Tip : on iOS Simulator, you can reproduce this by dragging while pressing "Option key" (⌥)
• look up/down : Move vertically two fingers in the same direction. Tip : on iOS Simulator, you can reproduce this by dragging while pressing "Command key" (⌘)

The below code snippets demonstrates how to select the "3D" manipulator.

bool lSuccess = mVgApp->editManipulatorManager()->selectManipulator("3D");

Constructor & Destructor Documentation

VgApplication::VgIManipulatorManager::VgIManipulatorManager ( )

inlineprotected

Constructor.

virtual VgApplication::VgIManipulatorManager::~VgIManipulatorManager ( )

inlinevirtual

Destructor.

Member Function Documentation

virtual VgApplication::VgManipulator* VgApplication::VgIManipulatorManager::editManipulatorObject ( const std::string &  pManipulatorName )

pure virtual

Returns a VgApplication::VgManipulator instance given its name.

It returns NULL if the specified manipulator has no public interface.

Parameters

pManipulatorName

Name of the manipulator to retrieve.

Returns

A VgApplication::VgManipulator pointer or NULL.

Version

2.0

virtual std::string VgApplication::VgIManipulatorManager::getCurrentManipulator ( ) const

pure virtual

Returns the current manipulator's name.

Version

2.0

virtual bool VgApplication::VgIManipulatorManager::selectManipulator ( const std::string &  pName )

pure virtual

Selects the current manipulator.

Having an active manipulator is almost always desired to provide the user with a mechanism to interact with the scene. Interaction is handled intuitively for the various hardware. For touch-screen devices, the view can be manipulated by dragging a finger. For other devices, view manipulation can be detected via the keypad.

Parameters

pName

The name of the manipulator. Supported manipulators include: "3D" and "animation".

Remarks

The default manipulator at startup depends on what is defined within the dataset configuration. For more information regarding the configuring dataset, see Data bundle configuration.

---

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

• VgIManipulatorManager.h