VgApplication::VgIManipulatorManager Class Reference

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

List of all members.

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

---

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

(

)

[inline, protected]

Constructor.

virtual VgApplication::VgIManipulatorManager::~VgIManipulatorManager

(

)

[inline, virtual]

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